gmail_search_messages
Search Gmail messages by query to retrieve message IDs, snippets, and labels without modifying mail.
Instructions
Searches Gmail at message level (vs gmail_list_threads which is thread level). Returns message IDs with snippet and labels. Read-only.
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_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Gmail search query, e.g. 'from:boss@company.com is:unread' | |
| page_token | No | ||
| max_results | No |