gmail_messages_list
List Gmail messages matching a search query to find specific emails by sender, subject, or labels. Filter results by user ID, label IDs, and maximum number returned.
Instructions
List Gmail messages matching a query.
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": {
"userId": "<userId>"
},
"name": "gmail_messages_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Gmail search query (e.g. "from:user@example.com subject:hello") | |
| userId | Yes | User ID (use 'me') | |
| labelIds | No | Label IDs to filter by | |
| maxResults | No | Max messages to return |