mail_search
Search emails in a specified folder by sender, subject, body, date, and other basic fields. Supports pagination, snippets, and filtering by unread status.
Instructions
Convenience folder search by basic fields. Prefer mail_search_advanced for richer filters and agent reliability.
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": {
"mailbox": "<mailbox>"
},
"name": "mail_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Recipient contains | |
| body | No | Body contains | |
| from | No | Sender contains | |
| sort | No | Sort by UID (default: desc/newest-first) | desc |
| limit | No | Max results (default 50, capped globally) | |
| since | No | Date since (ISO) | |
| before | No | Date before (ISO) | |
| cursor | No | Opaque pagination cursor from previous response | |
| unseen | No | Only unread | |
| mailbox | Yes | Folder to search (e.g. INBOX) | |
| subject | No | Subject contains | |
| returnPage | No | Return {items,nextCursor} instead of raw array | |
| includeSnippet | No | Include short plain-text snippet per message |