search_messages
Search a local read-only archive of messages, email, calendars, tasks, notes, and reminders by terms, dates, sender, or conversation to find matching records and previews.
Instructions
Search communication, calendars, tasks, notes, reminders and installed source records.
Use order='newest', limit=1 for the latest matching message, code or email. The default order is relevance. before/after are inclusive ISO 8601 timestamps with timezone offsets. match='all' requires all terms; match='any' matches alternate spellings and languages. Each term needs 2+ characters; double quotes group a phrase. sender is an exact source ID, not a display name. conversation_id limits one conversation. Returns previews with read_request; follow next_request for another page. Profile/channel metadata is excluded. Check context for collection and indexing gaps. Searches titles, bodies, source comments and extracted attachments. Work-item HTML is rendered as text. matched_fields identifies where terms occur; preview_field identifies the excerpt source. Relevance scores title, body, comments and attachments separately.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | ||
| limit | No | ||
| match | No | all | |
| order | No | relevance | |
| query | Yes | ||
| before | No | ||
| offset | No | ||
| sender | No | ||
| source | No | ||
| conversation_id | No |