# Googlephotos (verified)

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

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add googlephotos

# Browse available tools
npx -y @smithery/cli@latest tool list googlephotos

# Get full schema for a tool
npx -y @smithery/cli@latest tool get googlephotos GOOGLEPHOTOS_ADD_ENRICHMENT

# Call a tool
npx -y @smithery/cli@latest tool call googlephotos GOOGLEPHOTOS_ADD_ENRICHMENT '{}'
```

## Direct MCP Connection

Endpoint: `https://googlephotos.run.tools`

## Tools (13)

- `GOOGLEPHOTOS_ADD_ENRICHMENT` — Adds an enrichment at a specified position in a defined album.
- `GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS` — Adds one or more media items to an album in Google Photos.
- `GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS` — Unified action to upload media files and create them as items in Google Photos.
- `GOOGLEPHOTOS_BATCH_GET_MEDIA_ITEMS` — Returns the list of media items for the specified media item identifiers.
- `GOOGLEPHOTOS_CREATE_ALBUM` — Creates a new album in Google Photos.
- `GOOGLEPHOTOS_GET_ALBUM` — Returns the album based on the specified albumId.
- `GOOGLEPHOTOS_GET_MEDIA_ITEM_DOWNLOAD` — Downloads a media item from Google Photos and returns it as a file.
- `GOOGLEPHOTOS_LIST_ALBUMS` — Lists all albums shown to a user in the Albums tab of Google Photos.
- `GOOGLEPHOTOS_LIST_MEDIA_ITEMS` — Lists all media items from a user's Google Photos library.
- `GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS` — Searches for media items in a user's Google Photos library.
- `GOOGLEPHOTOS_UPDATE_ALBUM` — Updates an album's title or cover photo in Google Photos.
- `GOOGLEPHOTOS_UPDATE_MEDIA_ITEM` — Updates a media item's description in Google Photos.
- `GOOGLEPHOTOS_UPLOAD_MEDIA` — Upload a media file to Google Photos. Supports images (up to 200MB) and videos (up to 20GB).

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get googlephotos <tool-name>
```
