Advanced email search
mail_searchSearch for emails in one or all accounts using filters for sender, recipient, subject, body, date, and flags like read, starred, or attachments.
Instructions
Use this when searching one account or all accounts with folder, sender, recipient, CC, BCC, subject, body, date, read, starred, answered, draft, deleted, attachment, size, or pagination filters. Omitting filters lists recent mail.
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": "mail_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | ||
| to | No | ||
| bcc | No | ||
| body | No | ||
| from | No | ||
| text | No | ||
| after | No | ||
| draft | No | ||
| limit | No | ||
| query | No | ||
| before | No | ||
| cursor | No | ||
| unread | No | ||
| deleted | No | ||
| flagged | No | ||
| maxSize | No | ||
| minSize | No | ||
| subject | No | ||
| answered | No | ||
| accountId | No | ||
| mailboxId | No | Opaque mailbox id returned by list_mailboxes | |
| folderScope | No | inbox | |
| includeJunk | No | ||
| accountScope | No | all | |
| includeTrash | No | ||
| hasAttachments | No |