search_mail
Search email messages by sender, recipient, subject, date range, read status, flags, mailbox, account, or attachments. Results return newest first.
Instructions
Search mail, newest first. All filters combine. With Full Disk Access the search is fast and covers all mail. Without it, the search is slower, needs 'mailbox', and covers the date range only (default: last 30 days); 'to' and 'has_attachments' do not work then. Dates are ISO 8601, for example 2026-11-12 or 2026-11-12T09:30:00+01:00.
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_mail"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Part of a recipient address or name. | |
| from | No | Part of the sender address or name. | |
| limit | No | Most results to return. Default 25, maximum 200. | |
| query | No | Words in the subject or the sender. Ignores case. | |
| since | No | Received at or after this. ISO 8601, for example 2026-11-12 or 2026-11-12T09:30:00+01:00 | |
| before | No | Received before this. A date-only value means the start of that day. | |
| unread | No | true for unread only, false for read only. | |
| account | No | Account id or name. | |
| flagged | No | true for flagged only, false for not flagged. | |
| mailbox | No | Mailbox name or path, for example INBOX. Ignores case. | |
| subject | No | Part of the subject. | |
| flag_color | No | Only messages flagged with this color. Do not combine it with 'flagged' false. | |
| has_attachments | No | true or false. |