search_messages
Find recent Apple Mail messages by sender or subject in a selected account and mailbox; read-only and does not search bodies.
Instructions
Search recent messages by subject or sender in one mailbox. Read-only; bodies are not searched.
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": {
"account": "<account>",
"query": "<query>"
},
"name": "search_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of messages to return. | |
| query | Yes | Case-insensitive text to match against sender or subject. | |
| account | Yes | Apple Mail account name. | |
| mailbox | No | Mailbox name. Usually INBOX. | INBOX |
| scan_limit | No | How many recent messages Apple Mail may inspect. |