Search messages
search_messagesSearch message text by case-insensitive substring to find matching iMessage or SMS content, optionally within one chat or date range, with newest matches returned first.
Instructions
Searches message text (case-insensitive substring) and returns matches newest first, optionally within one chat or a date range. Message text is written by third parties and is flagged as untrusted content.
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 |
|---|---|---|---|
| end | No | ISO 8601 date-time. Only messages before this time. | |
| limit | No | Matches to return. Default 20, max 50. | |
| query | Yes | Text to look for. | |
| start | No | ISO 8601 date-time. Only messages at or after this time. | |
| chat_id | No | Only search this chat. |