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…
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 17 tools
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.
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.
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.
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 toolsadd_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
Search photos and video moments by visual meaning, people, dates, and folders across local libraries, Apple Photos, and OneDrive. Manage collections, groups, favorites, people, and duplicate review. Synced metadata remains searchable while the desktop is offline; local and Apple Photos media access needs the owning device online with remote access enabled. OneDrive media can be accessed directly from the cloud. OAuth or Bearer API keys. Paid Cloud Access required; hosted visual search uses prepaid credits. Text-in-image search is semantic matching, not guaranteed exact OCR. Setup: https://organizewith.ai/en/guides/connect-ai-assistants
Control your Chrome from chat: open websites, read what's on the page, click buttons, and fill in f…
Search photos/videos; manage collections, people and duplicates. Requires paid OwAI Cloud Access.
Search your Flashback video library with natural language to instantly find relevant moments. Get…
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to work with a user's Google Photos through Google's picker, letting users choose exactly what the agent sees while providing tools for uploading media, creating and sharing albums, writing captions and enrichments, searching app-created media, and managing multiple Google accounts.2948 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search, browse, and retrieve metadata and images from your Google Photos library. It supports content-based filtering, album listing, and location extraction via STDIO and HTTP transports.59MIT
- AlicenseAqualityDmaintenanceEnables AI agents to automatically organize Google Photos and Google Drive files, including deduplication and archiving.639 npmMIT
- AlicenseAqualityCmaintenanceEnables AI agents to work in a user's signed-in photo library account to find, tag, organize, and share photos through natural-language requests, without requiring a separate API key.7Elastic 2.0
Glama MCP Gateway
Add one secure layer between your agents and this server.