gmail_search
Search Gmail messages by query and return sender, subject, date, snippet, labels, and attachment info, or use ID-only format for bulk operations.
Instructions
Search Gmail. Returns enriched metadata per match (from/subject/date/snippet/labelIds/hasAttachments) by default. Set format='ids' for the lighter ID-only response (cheaper, useful for piping to bulk ops).
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": {
"query": "<query>"
},
"name": "gmail_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Google account email. May be omitted when exactly one account is configured; required when multiple accounts are configured. | ||
| query | Yes | Gmail search query | |
| format | No | Default 'metadata'. Use 'ids' to skip per-message header fetches. | |
| page_token | No | Pagination cursor from a previous call | |
| max_results | No | Default 20 |