# Google Photos — MCP server on mcp.ai
> Google Photos is a cloud-based photo storage and organization service offering automatic backups, AI-assisted search, and shared albums for personal and collaborative media management

By: mcp.ai · official
Page: https://mcp.ai/googlephotos

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_googlephotos?ms=1781543520000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/googlephotos/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/googlephotos/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/googlephotos/skill.md
Postman collection (v2.1): https://mcp.ai/googlephotos/postman.json

## Tools
- googlephotos_add_enrichment(albumId: string, albumPosition?: object, newEnrichmentItem: object) — Adds an enrichment at a specified position in a defined album.
- googlephotos_batch_add_media_items(albumId: string, mediaItemIds: string[]) — Adds one or more media items to an album in google photos.
- googlephotos_batch_create_media_items(files: object[], albumId: string, albumPosition?: object) — Unified action to upload media files and create them as items in google photos.
- googlephotos_batch_get_media_items(mediaItemIds: string[]) — Returns the list of media items for the specified media item identifiers.
- googlephotos_create_album(id?: string, title: string, productUrl?: string, isWriteable?: boolean, mediaItemsCount?: string, coverPhotoBaseUrl?: string, coverPhotoMediaItemId?: string) — Creates a new album in google photos.
- googlephotos_get_album(albumId: string) — Returns the album based on the specified albumid.
- googlephotos_get_media_item_download(mediaItemId: string) — Downloads a media item from google photos and returns it as a file.
- googlephotos_list_albums(pageSize?: integer, pageToken?: string, excludeNonAppCreatedData?: boolean) — Lists all albums shown to a user in the albums tab of google photos.
- googlephotos_list_media_items(pageSize?: integer, pageToken?: string) — Lists all media items from a user's google photos library.
- googlephotos_search_media_items(albumId?: string, filters?: object, orderBy?: string, pageSize?: integer, pageToken?: string) — Searches for media items in a user's google photos library.
- googlephotos_update_album(title?: string, albumId: string, coverPhotoMediaItemId?: string) — Updates an album's title or cover photo in google photos.
- googlephotos_update_media_item(description?: string, mediaItemId: string) — Updates a media item's description in google photos.
- googlephotos_upload_media(description?: string, file_to_upload: object) — Upload a media file to google photos. supports images (up to 200mb) and videos (up to 20gb).

## Links
Docs: https://mcp.ai/docs/mcps/googlephotos
Website: https://mcp.ai/mcps/googlephotos