Google Photos MCP integration for AI agents.
Connect AI agents to Google Photos through 18 structured actions, including batch get media items, add enrichment, and delete picker session. Review authenti…
- ACTION CONTRACTS
- 18
- AUTHENTICATION
- OAuth 2.0
- SOURCE STATUS
- Provider-backed
CATALOG SOURCE REVIEWED AUGUST 23, 2026 / ACTION NAMES AND SCHEMAS DERIVED FROM WORKING MACHINES PROVIDER SOURCE
CAPABILITY PROFILE
What the Google Photos integration exposes
The Google Photos Agent App exposes 18 provider-backed actions for storage and design work. Its current contract lets an authorized agent fetch multiple google photos media items by id, add an enrichment item to a google photos album, and delete a google photos picker session. These operations are called through Working Machines as typed capabilities rather than through browser navigation or copied UI steps.
A connection uses OAuth 2.0. Before execution, the agent can inspect the selected action, its required fields, declared scopes, and expected output contract. Provider credentials remain inside the Working Machines runtime; the calling agent receives the capability and its structured result, not the underlying secret.
For reliable operation, start with the narrowest action that satisfies the task, resolve stable provider identifiers before changing state, and validate the returned object or status after execution. Availability still depends on the connected Google Photos account, granted provider permissions, workspace policy, region, plan, and upstream API behavior.
VERIFIED ACTION SAMPLE
Real Google Photos capabilities.
Showing 12 of 18 actions. Risk labels are conservative signals based on operation names, not substitutes for provider documentation or runtime policy.
batch_get_media_itemsREADFetch multiple Google Photos media items by ID.
INPUTS: mediaItemIds
add_enrichmentWRITEAdd an enrichment item to a Google Photos album.
INPUTS: albumId / albumPosition / newEnrichmentItem
delete_picker_sessionHIGH IMPACTDelete a Google Photos Picker session.
INPUTS: sessionId
batch_add_media_itemsWRITEAdd existing Google Photos media items to an album.
INPUTS: albumId / mediaItemIds
batch_create_media_itemsWRITEBatch create Google Photos media items from URLs or base64 payloads.
INPUTS: urls / mediaFiles / albumId / albumPosition
create_albumWRITECreate a Google Photos album.
INPUTS: title
create_picker_sessionWRITECreate a Google Photos Picker session for selecting items from the user's library.
INPUTS: maxItemCount
get_albumREADFetch one Google Photos album by ID.
INPUTS: albumId
get_media_item_downloadREADDownload a Google Photos Library API media item created by this application through local file transit.
INPUTS: mediaItemId
get_picked_media_item_downloadREADDownload a picked Google Photos media item through local file transit using its trusted temporary base URL.
INPUTS: baseUrl / mimeType / filename / type / mediaFileMetadata
get_picker_sessionREADGet the current state of a Google Photos Picker session.
INPUTS: sessionId
list_albumsREADList Google Photos albums visible to the current application connection. If you need the user to choose from their existing Google Photos library, use the Picker actions instead.
INPUTS: pageSize / pageToken
INPUT CONTRACTS
Know what the action needs before it runs.
batch_get_media_items
mediaItemIdsREQUIRED- The list of media item IDs to fetch (1-50).
add_enrichment
albumIdREQUIRED- The ID of the album to add the enrichment to.
albumPositionREQUIRED- The position type within the album.
newEnrichmentItemREQUIRED- One Google Photos enrichment variant.
delete_picker_session
sessionIdREQUIRED- The ID of the picker session to delete.
batch_add_media_items
albumIdREQUIRED- The ID of the album to add the media items to.
mediaItemIdsREQUIRED- The list of media item IDs to add to the album (1-50).
PROVIDER-SPECIFIC WORKFLOWS
Jobs this Agent App can support
Inspect Batch Get Media Items
Fetch multiple Google Photos media items by ID. Use this as a bounded discovery step, retain the returned identifier, and avoid expanding the read beyond the task's stated scope.
batch_get_media_itemsControl Add Enrichment
Add an enrichment item to a Google Photos album. Resolve the target first, present material changes for confirmation, and make retries idempotent where the provider supports it.
add_enrichmentVerify with Get Album
Fetch one Google Photos album by ID. Compare the returned provider state with the intended outcome and preserve stable IDs or canonical links in the run record.
get_albumSAFETY BOUNDARY
Operate Google Photos with explicit limits
- Authorize Google Photos with OAuth 2.0 and grant only the provider access required by the selected actions.
- 9 actions are change-capable by name. Confirm the target identity and material parameters before allowing a write.
- Treat `delete_picker_session` as high-impact operations and require an explicit approval boundary.
- The sampled contract declares provider scopes including `https://www.googleapis.com/auth/photoslibrary.appendonly`, `https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata`, `https://www.googleapis.com/auth/photospicker.mediaitems.readonly`, and `https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata`; verify the complete action contract before execution.
- After a call, inspect the structured result and execution record before reporting that the Google Photos task completed successfully.
CONNECTION MODEL
OAuth 2.0
Google Photos uses OAuth 2.0. Connection requirements and availability are determined by the provider and the Working Machines deployment.
Working Machines stores provider credentials behind the execution boundary. An agent can use an authorized connection identity, but catalog discovery alone does not reveal OAuth tokens, API keys, or provider secrets.
- READ SIGNALS
- 9
- WRITE SIGNALS
- 8
- HIGH IMPACT
- 1
- REVIEW SIGNALS
- 0
EVIDENCE AND AVAILABILITY
Provider reference
Action names, input fields, authentication types, and counts on this page are generated from the Working Machines provider catalog. Provider behavior, quotas, object semantics, account eligibility, and regional availability remain governed by Google Photos.