Google Photos MCP by Nova (CIVAI)

Working Security A

co.civai.nova/mcp-google_photosv1.0.0 Domain verified

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

Productivity

Watch Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-14T17:02:47.933716Z",
      "publishedAt": "2026-11-14T17:02:47.933716Z",
      "statusChangedAt": "2026-11-14T17:02:47.933716Z"
    }
  },
  "server": {
    "name": "co.civai.nova/mcp-google_photos",
    "icons": [
      {
        "src": "https://photos.google.com/favicon.ico"
      }
    ],
    "title": "Google Photos MCP by Nova (CIVAI)",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://nova.civai.co/mcp/agents/mcp-google_photos",
        "type": "streamable-http"
      }
    ],
    "version": "1.0.0",
    "websiteUrl": "https://nova.civai.co/agent/mcp-google_photos",
    "description": "Sort, search and tidy your Google Photos from chat: find photos and videos, read their details, dow…"
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://nova.civai.co/mcp/agents/mcp-google_photos

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_to_album

Add library items to an existing album.

album_keystring, required

Album key from list_albums or create_album.

media_keysstring, required

Library media keys (AF1Qip...) from list_media / search_media, as a JSON array or comma-separated.

google_account_emailstring, required

The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.

notification_messagestring

Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Argument	Type	Description
size	string	original for the uploaded file (photo or video, byte-exact), or a size spec such as w512-h512, s1024, w2048-h2048-no for an image/thumbnail. Default w512-h512.
media_key*	string	One library media key.
output_dir	string	Local folder to save into. Default: <tmp>/google_photos_downloads.
return_base64	string	true to also inline the bytes (files up to 1.5 MB).
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
after	string	Only items taken on/after this time: YYYY-MM-DD, ISO-8601 UTC, or epoch ms.
before	string	Only items taken on/before this time (a bare date includes the whole day).
page_size	string	Target number of items, 1-500 (default 100). Google pages in its own chunk sizes, so a call can return somewhat more; keep paging with next_page_token.
media_type	string	Filter by type. Default all.
page_token	string	next_page_token from the previous list_media call.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
query*	string	Search text, e.g. sunset, food, a named person, a city.
page_size	string	Max results, 1-500. Default 100.
page_token	string	next_page_token from the previous call.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
reset	boolean	Clear the choice: back to how the user signed in.
route	string	app: the app's default; direct: the server; fixed: the always-on VPN exit; vpn_country: a VPN exit in `country`.
locale	string	e.g. en-NG
country	string	ISO country code for vpn_country, e.g. NG, GB, US.
timezone	string	IANA time zone, e.g. Africa/Lagos.
user_agent	string	The browser user agent to present.
impersonate	string	Connection fingerprint target (e.g. chrome145); derived from the user agent when left out.
accept_language	string	e.g. en-NG,en;q=0.9

Argument	Type	Description
confirm*	string	Must be true, after the user approved the exact items.
media_keys*	string	Up to 50 library media keys to move to Trash, JSON array or comma-separated.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Google Photos MCP by Nova (CIVAI)

Registry entry

Try it

add_to_album

Google Photos MCP by Nova (CIVAI)

Registry entry

Try it

add_to_album

Install

Tools (17)

Security checkA100/100

Argument	Type	Description
album_key*	string	Album key from list_albums or create_album.
media_keys*	string	Library media keys (AF1Qip...) from list_media / search_media, as a JSON array or comma-separated.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
archive	string	true (default) or false to unarchive.
media_keys*	string	Library media keys (AF1Qip...) from list_media / search_media, as a JSON array or comma-separated.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
title*	string	Album title.
media_keys	string	Library media keys (AF1Qip...) from list_media / search_media, as a JSON array or comma-separated.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
media_key*	string	One library media key (AF1Qip...).
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
album_key	string	Optional: list the items of this album.
page_token	string	next_page_token from the previous call.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
album_key*	string	Album key.
media_keys	string	Library media keys (AF1Qip...) from list_media / search_media, as a JSON array or comma-separated.
album_item_keys	string	Optional: album-item keys from list_albums(album_key) instead of library media keys.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
favorite	string	true (default) or false.
media_keys*	string	Library media keys (AF1Qip...) from list_media / search_media, as a JSON array or comma-separated.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

Argument	Type	Description
chunk_mb	string	Chunk size in MB, 1-256. Default 8.
album_key	string	Optional album to add the upload to.
file_name	string	Optional name to store it under (default: the file's own name).
file_path*	string	Absolute path of a local image or video file.
google_account_email*	string	The signed-in Google account email whose Google Photos library to use (e.g. the one at /u/1/). Call list_accounts first and confirm with the user; do not guess.
notification_message	string	Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.