gmail_download_attachment
Downloads a Gmail attachment's content by message ID and file name, returning small files inline as base64 or larger ones as a one-time link the human opens in their own signed-in browser.
Instructions
Download a Gmail attachment's content. Identify the attachment by the name returned from gmail_list_message_attachments. Returns {delivery: 'inline', name, mime_type, size_bytes, content_base64} for a small attachment, or {delivery: 'link', name, size_bytes, download_url, expires_at, note} for a larger one: a one-time link the human opens in their own signed-in browser. Requires user approval.
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": {
"message_id": "<message_id>",
"attachment_name": "<attachment_name>",
"reason": "<reason>"
},
"name": "gmail_download_attachment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | One sentence: why are you calling this tool right now? | |
| message_id | Yes | Id of the Gmail message, from gmail_list_messages (its id field). | |
| attachment_name | Yes | File name of the attachment, exactly as gmail_list_message_attachments returns it in its name field; a name that matches none fails. |