search
Locate iMessage messages by their text content. Filter results by conversation and date to find specific messages in your macOS history.
Instructions
Search decoded message bodies for a substring (case insensitive).
Optionally restrict to one chat (same matching rules as read_thread) and
to messages on or after since ("YYYY-MM-DD" or "YYYY-MM-DD HH:MM").
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": {
"text": "<text>"
},
"name": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat | No | ||
| text | Yes | ||
| limit | No | ||
| since | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |