Upload Photos
upload_photosBatch upload photos to Google Photos, optionally adding them to an existing or new album with descriptions.
Instructions
Upload one or more photos to Google Photos with batch optimization
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| album_id | No | ID of existing album to add photos to. | |
| file_paths | Yes | Single file path (str) or list of file paths to upload. Required. | |
| description | No | Description for photos (applies to single photo or all in batch). | |
| create_album | No | Name of new album to create and add photos to. | |
| user_google_email | No | The user's Google email address for Photos access. If None, uses the current authenticated user from FastMCP context (auto-injected by middleware). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Error message if operation failed | |
| failed | No | List of failed uploads with error information | |
| success | No | Whether the overall upload operation succeeded | |
| album_id | No | Album ID where photos were uploaded (if specified) | |
| successful | No | List of successfully uploaded photos with their details | |
| user_email | No | Email address of the user who uploaded the photos | |
| total_count | No | Total number of files processed | |
| failed_count | No | Number of failed uploads | |
| text_summary | No | Human-readable summary of the upload operation | |
| successful_count | No | Number of successfully uploaded files | |
| created_album_name | No | Name of newly created album (if a new album was created) | |
| upload_time_seconds | No | Total time taken for the upload operation in seconds |