search
Find Gmail messages across connected mailboxes using Gmail query syntax and return matching IDs, dates, senders, subjects, and labels, newest first.
Instructions
Find messages with Gmail search syntax. Returns id, date, from, subject and labels, newest first.
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": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max | No | Default 25, at most 500 | |
| query | Yes | Gmail search syntax, e.g. "category:promotions older_than:30d" | |
| mailbox | Yes | A connected mailbox address (see list_mailboxes) |