mail_query_by_folder
Search emails in a specified folder with free-text queries. Supports filtering by subject, body, from, to, and returns results sorted by date.
Instructions
Convenience free-text query in one folder. Prefer mail_search_advanced for canonical searches.
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>",
"query": "<query>"
},
"name": "mail_query_by_folder"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort by UID (default: desc/newest-first) | desc |
| limit | No | Max results (default 50, capped globally) | |
| query | Yes | Free-text query to match | |
| cursor | No | Opaque pagination cursor from previous response | |
| fields | No | Fields to search. Defaults to subject, body, from, to. | |
| mailbox | Yes | Folder name, e.g. INBOX | |
| returnPage | No | Return {items,nextCursor} instead of raw array | |
| includeSnippet | No | Include short plain-text snippet per message |