search_threads

Active

declared in 1.17.0

Find or list chat threads/conversations — by topic, participant, unread/unanswered status, or recency. Omit `query` to list threads by filter. For message content use search.messages; for files use search.files. `since` filters by recency and pairs with only_unread / only_unanswered.

Parameters schema

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum threads to return."
    },
    "query": {
      "type": "string",
      "description": "Topic/keyword to search threads for. OMIT to list threads by filter."
    },
    "since": {
      "type": "string",
      "description": "ISO date (YYYY-MM-DD). Only threads with any message activity since this date (recency filter, not 'unanswered'). OMIT to skip."
    },
    "only_unread": {
      "type": "boolean",
      "description": "Limit to threads with unread messages. OMIT to include read threads."
    },
    "only_unanswered": {
      "type": "boolean",
      "description": "Limit to threads where the last message is incoming (you haven't replied). Covers 'threads I haven't replied to'. OMIT to include answered threads too."
    },
    "participant_name": {
      "type": "string",
      "description": "Filter to threads with this participant/contact. OMIT to include everyone (do NOT pass an empty string)."
    }
  }
}

What this tool wraps· 2 endpoints

min confidence0.70 0.50

Parent server

io.github.saloprj/dialogbrain

https://github.com/saloprj/dialogbrain-mcp

1/7 registries

View full server →