gmail_search
Search Gmail messages in a specific account using Gmail query syntax, with optional result limits. Returns matching messages without attachment details; use message read to view attachments.
Instructions
Search Gmail messages on one account. Results do not include attachment info (fetched with format: metadata, which never populates the MIME parts tree) — use gmail_read_message on a specific message to see its attachments.
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": {
"account": "<account>",
"query": "<query>"
},
"name": "gmail_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Gmail search query, e.g. from:alice@example.com newer_than:7d. | |
| account | Yes | Configured Gmail account alias, e.g. work, personal, support. | |
| maxResults | No |