download_media
Save the bytes of a thumbnail at any size or the original file to a local folder and return the path (plus sha256, and base64 for small files when asked). The image URLs need the signed-in cookies, so always fetch through this tool.
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": {
"google_account_email": "<google_account_email>",
"media_key": "<media_key>"
},
"name": "download_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | original for the uploaded file (photo or video, byte-exact), or a size spec such as w512-h512, s1024, w2048-h2048-no for an image/thumbnail. Default w512-h512. | |
| media_key | Yes | One library media key. | |
| output_dir | No | Local folder to save into. Default: <tmp>/google_photos_downloads. | |
| return_base64 | No | true to also inline the bytes (files up to 1.5 MB). | |
| google_account_email | Yes | The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess. | |
| notification_message | No | Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names. |