Skip to main content
Glama

Google Photos MCP by Nova (CIVAI)

Server Details

Sort, search and tidy your Google Photos from chat: find photos and videos, read their details, dow…

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A3.7/5.0

Scored across 17 tools

Disambiguation4/5

Most tools have clear resource-and-action boundaries, including distinct upload/download, archive/trash, and album-membership operations. check_session and list_accounts overlap in reporting signed-in accounts, and start_browser_auth incorrectly tells agents to call the nonexistent session_status tool rather than check_session.

Naming Consistency5/5

All tools use consistent snake_case verb_noun naming, with predictable pairs such as get_network_identity/set_network_identity and list_media/search_media. The more specialized start_browser_auth name still fits the same general convention.

Tool Count4/5

Seventeen tools is slightly above the typical ideal range, and the network-identity pair is peripheral to photo management. Nevertheless, the set is not severely bloated given its coverage of authentication, media, albums, and session infrastructure.

Completeness4/5

Core workflows are well covered: authentication, account selection, library listing and search, metadata retrieval, upload/download, favorites, archiving, trashing, and album creation and membership. Obvious remaining gaps include album rename/delete and restoration from Trash, so album and trash lifecycles are not complete.

Available Tools

17 tools
add_to_albumCInspect

Add library items to an existing album.

Inputs: album_key (required), media_keys (required), google_account_email (required), notification_message.

archive_mediaAInspect

Archive items (they leave the main photo grid but stay in albums, search and Archive), or unarchive with archive=false.

Inputs: media_keys (required), google_account_email (required), archive, notification_message.

check_sessionAInspect

Check that the saved Google Photos session still works and list the signed-in accounts. Read-only: it never refreshes the session. If it reports the session expired, the user reconnects with start_browser_auth.

Inputs: notification_message.

create_albumBInspect

Create a new album with a title, optionally adding library items to it straight away.

Inputs: title (required), google_account_email (required), media_keys, notification_message.

download_mediaAInspect

Save the bytes of a thumbnail at any size or the original file to a local folder and return the path (plus sha256, and base64 for small files when asked). The image URLs need the signed-in cookies, so always fetch through this tool.

Inputs: media_key (required), google_account_email (required), size, output_dir, +2 more.

get_mediaAInspect

Full metadata for one item: filename, taken time and timezone offset, file size, dimensions, photo/video and duration, camera make/model/aperture/ISO/exposure when present, face count and named people, favorite flag, location (latitude/longitude from the file's GPS plus Google's place name; null when the item has none), plus thumbnail and original download URLs (those need the session: use download_media for bytes).

Inputs: media_key (required), google_account_email (required), notification_message.

get_network_identityAInspect

Where this user's requests to the site leave from (a VPN country, the server, or the app's default) and which browser they present. Read-only.

Inputs: no named parameters.

list_accountsAInspect

List the Google accounts signed in to the saved session with their /u// slot. Call first and confirm with the user which email holds their photos.

Inputs: notification_message.

list_albumsBInspect

List the user's albums (album_key, title, created), or pass album_key to list the items inside that album.

Inputs: google_account_email (required), album_key, page_token, notification_message.

list_mediaAInspect

Page through the Google Photos library timeline, newest first: media key, taken/uploaded time, dimensions, photo or video (+duration), favorite flag and a thumbnail URL. Optional date range (after/before) and type filter. Pass next_page_token to continue.

Inputs: google_account_email (required), after, before, page_size, +3 more.

remove_from_albumAInspect

Remove items from an album. The photos stay in the library; only the album membership changes.

Inputs: album_key (required), google_account_email (required), media_keys, album_item_keys, +1 more.

search_mediaAInspect

Search the library the way the Google Photos search box does: free text (sunset, food, beach), a person's name from People, a place, or a thing. Returns the same item shape as list_media.

Inputs: query (required), google_account_email (required), page_size, page_token, +1 more.

set_favoriteCInspect

Mark items as favorites (favorite=true, default) or remove the favorite (favorite=false).

Inputs: media_keys (required), google_account_email (required), favorite, notification_message.

set_network_identityAInspect

Choose where this user's requests to the site leave from and which browser they present, only when the user asks (e.g. 'connect through Nigeria', 'use my own user agent'). Sites may ask the user to sign in again when this changes. reset=true goes back to how they signed in.

Inputs: reset, route, locale, country, +4 more.

start_browser_authAInspect

Open Google Photos sign-in only when needed. If the saved session is still valid, this tool returns success immediately and does not open the viewer. Call session_status first. Use force_reconnect only when the user explicitly wants to wipe the saved cookie and sign in again (destructive).

Inputs: force_reconnect.

trash_mediaAInspect

Move items to Google Photos' Trash, where they stay recoverable for 60 days. Never deletes permanently and cannot empty the Trash. Requires confirm=true; max 50 items per call. Show the user the exact items and get their yes first.

Inputs: confirm (required), media_keys (required), google_account_email (required), notification_message.

upload_mediaAInspect

Upload a local photo or video file (up to 10 GB) into the library, optionally into an album. Sent in resumable chunks, so a dropped connection resumes instead of restarting. Returns the new item. Uploading a file that is already in the library returns the existing item.

Inputs: file_path (required), google_account_email (required), chunk_mb, album_key, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources