Upload Folder Photos
upload_folder_photosUpload all photos from a local folder to Google Photos, with optional recursion into subfolders and album creation or assignment to an existing album.
Instructions
Upload all photos from a folder (with optional recursion) to Google Photos
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| album_id | No | ID of existing album to add photos to. | |
| recursive | No | Whether to include subfolders. Defaults to True. | |
| folder_path | Yes | Local path to folder containing photos. Required. | |
| create_album | No | Name of new album to create for these photos. | |
| 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 folder upload operation succeeded | |
| album_id | No | Album ID where photos were uploaded (if specified) | |
| recursive | No | Whether subfolders were included | |
| successful | No | List of successfully uploaded photos with details | |
| user_email | No | Email address of the user | |
| folder_path | Yes | Local folder path that was uploaded | |
| total_found | No | Total number of photo files found in the folder | |
| failed_count | No | Number of failed uploads | |
| text_summary | No | Human-readable upload summary | |
| 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 | |
| success_rate_percent | No | Percentage of successful uploads |