search
Locate emails across multiple folders and mailboxes using keywords or Gmail-style filters, retrieving newest matches or paged lists.
Instructions
Search emails across many folders at once: by default every folder of the first mailbox except Trash and Spam; scope="all" covers every mailbox this app may use, a mailbox address or name all its folders, or give one folder. With query: keyword search returning the 20 newest matches with their text (cut at 3,000 characters; thread has the rest), best for questions about a topic. Without query: a paged list, one line per email, matching filter (same syntax as emails). To page through one folder use emails. Changes nothing.
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"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Which page of results, starting at 1. | |
| order | No | descending (newest first) or ascending (oldest first). | descending |
| query | No | Keywords to search for. Returns up to 20 newest matches with full bodies. Leave empty to list emails matching filter instead. | |
| scope | No | Where to look: 'all' for every mailbox this app may use, a mailbox address or name for all its folders, or one folder. Empty means the first mailbox, without Trash and Spam. | |
| filter | No | Gmail-style filter, can combine: from:, to:, cc:, subject:, before:yyyy/MM/dd, after:yyyy/MM/dd, newer_than:7d (d/w/m/y), older_than:, is:unread, is:read, is:starred, is:answered, has:attachment, filename:<name>, plain words, and -term to exclude. | |
| page_size | No | How many emails per page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |