Search messages
search_messagesSearch synced chat networks with hybrid semantic, keyword, and fuzzy queries; return ranked excerpts with context and citable message IDs, and filter by sender, chat, network, direction, and time.
Instructions
Hybrid semantic + keyword + fuzzy search across every synced chat and network. Returns ranked matches as conversation excerpts with surrounding messages, each line tagged with a citable message id. Filter by sender, person, chat, network, direction and time (when accepts plain English such as 'last spring' or 'march 2024'). Leave query empty to list messages matching the filters, newest first. Paginate with next_cursor.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat | No | Chat title fragment or numeric conversation id. | |
| mode | No | hybrid | |
| when | No | Time range in plain English, e.g. 'last summer'. | |
| after | No | ISO date or datetime (inclusive). | |
| limit | No | ||
| query | No | What to look for: a topic, phrase or question. | |
| before | No | ISO date or datetime (exclusive). | |
| cursor | No | next_cursor from a previous call with the same query. | |
| format | No | text: compact, citation-tagged transcript (default). json: the full structured result. | text |
| person | No | Only conversations that include this person. | |
| sender | No | Who wrote the message (name or handle). 'me' = the user. | |
| context | No | Messages of context before and after each match. | |
| network | No | e.g. whatsapp, signal, instagram, imessage, telegram. | |
| direction | No |