File Storage
🖼️ Google Photos integration
Access levels: Read-only · Read + upload · Verified
File Storage
Access levels: Read-only · Read + upload · Verified
Connect Google Photos once and every agent in your squad can work in it for you, with exactly as much access as you decide to give, and a receipt for every call it makes.
You can change an account's access level any time under Manage. It applies instantly, no re-authorization. If the connection ever expires, the card shows Reconnect; one click re-authorizes the same account with the same settings.
Multiple accounts: connect as many as you need (say, yours and a client's). One is primary. Agents use it unless a mission says otherwise.
The level you pick at connect time is enforced on our side for every agent call: an agent can never do more than the level allows, no matter what it's asked.
| Level | What it allows | |
|---|---|---|
| Read-only | View your photos and albums. | |
| Read + upload | View photos and upload new ones. | Recommended |
On top of the connection's level, every agent can be individually allowed, scoped down, or denied for this app from the Integrations page. Deny an agent and it doesn't even see the connection.
The 14 tools agents use in Google Photos through Mission Control, and the lowest access level that includes each. Agents discover these themselves. You never have to name a tool; asking in plain language is enough.
| Tool | What it does | Access level |
|---|---|---|
Add enrichmentGOOGLEPHOTOS_ADD_ENRICHMENT | Adds an enrichment at a specified position in a defined album. | Read + upload |
Batch add media itemsGOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS | Adds one or more media items to an album in Google Photos. | Read + upload |
Batch create media itemsGOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS | Batch upload and create media items in Google Photos. | Read + upload |
Batch get media itemsGOOGLEPHOTOS_BATCH_GET_MEDIA_ITEMS | Returns the list of media items for the specified media item identifiers. | All levels |
Create albumGOOGLEPHOTOS_CREATE_ALBUM | Creates a new album in Google Photos. | Read + upload |
Get albumGOOGLEPHOTOS_GET_ALBUM | Returns the album based on the specified albumId. | All levels |
Get media item downloadGOOGLEPHOTOS_GET_MEDIA_ITEM_DOWNLOAD | Downloads a media item from Google Photos and returns it as a file. | All levels |
List albumsGOOGLEPHOTOS_LIST_ALBUMS | Lists all albums shown to a user in the Albums tab of Google Photos. | All levels |
List media itemsGOOGLEPHOTOS_LIST_MEDIA_ITEMS | Lists media items created by this application from Google Photos. | All levels |
List shared albumsGOOGLEPHOTOS_LIST_SHARED_ALBUMS | [DEPRECATED - sunset March 31, 2025] Lists all shared albums available in the Sharing tab of the user's Google Photos app. | All levels |
Search media itemsGOOGLEPHOTOS_SEARCH_MEDIA_ITEMS | Searches for media items in a user's Google Photos library. | All levels |
Update albumGOOGLEPHOTOS_UPDATE_ALBUM | Updates an album's title or cover photo in Google Photos. | Read + upload |
Update media itemGOOGLEPHOTOS_UPDATE_MEDIA_ITEM | Updates a media item's description in Google Photos. | Read + upload |
Upload mediaGOOGLEPHOTOS_UPLOAD_MEDIA | Upload a media file to Google Photos. Supports images (up to 200MB) and videos (up to 20GB). | Read + upload |
Just ask in plain language: “check Google Photos for …”, “create … in Google Photos”, “every Monday, … ”, and the agent finds the right tool, runs it, and reports back with a receipt in your Runs ledger. Anything outward-facing (sending, posting, publishing) that a mission didn't clearly authorize comes back to you as a ticket first.
| Agent says | What's happening | Fix |
|---|---|---|
| "Google Photos isn't connected" | No active connection (or this agent is denied) | Connect on the Integrations page; check the agent's per-app policy |
| "The connection has expired" | Google Photos ended the authorization (they all do periodically) | Click Reconnect on the account, same settings, one click |
| "I'm not allowed to do that" | The action is above the account's access level, or the agent is scoped down | Raise the level under Manage, or adjust that agent's policy |
| It did something unexpected | The ask was ambiguous (e.g. matched an existing item) | Be explicit, "create a NEW …", and give agents a working folder where relevant |