List drafts
list_draftsRetrieve Gmail draft IDs and thread IDs. Filter drafts with Gmail query syntax and paginate through results to locate specific drafts for reading or management.
Instructions
Lists the mailbox's drafts: draft id plus the underlying message's id and threadId (no subjects — read one with get_draft). query filters with Gmail query syntax (e.g. subject:invoice); paginate with page_token from nextPageToken.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_drafts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Gmail query syntax, e.g. "from:amy@example.com is:unread newer_than:7d has:attachment subject:invoice". Same operators as the Gmail search box. | |
| page_size | No | Drafts per page (1..500, API default 100). | |
| page_token | No | nextPageToken from the previous page. |