Download photo
photos_downloadDownload specific timeline photos from Proton Drive to a local folder using /photos/ paths; choose skip, rename, or remove for filename conflicts.
Instructions
Download photos from your timeline to a local folder by /photos/ path. /albums// paths are rejected by the CLI — use the /photos/ path. Timeline photos can share a filename: with conflictStrategy 'remove' or 'skip' only one copy survives locally; use 'rename' to keep all. Fails if any item fails. Requires confirmed=true when conflictStrategy is 'remove' (it deletes the existing LOCAL file).
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": {
"photoPaths": "<photoPaths>",
"localFolder": "<localFolder>"
},
"name": "photos_download"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirmed | No | Must be true; only after the user approved this exact action. | |
| photoPaths | Yes | One or more absolute photo paths to download (each must start with '/'). E.g. ['/photos/IMG_001.jpg'] | |
| localFolder | Yes | Absolute local destination folder (must start with '/'). Created if it does not exist. | |
| conflictStrategy | No | 'skip' keeps the existing local file (default). 'rename' downloads under a unique name. 'remove' deletes the local file first — confirm with user. |