Google Photos MCP by Nova (CIVAI)

co.civai.novaPublished by nova.civai.coOfficial publisherv1.0.0Updated Nov 14, 2026

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

The publisher's own server: Blogger Agent by Nova (CIVAI)

VerifiedStreamable HTTPWeb executableFiles & StorageMedia & Design

Overview

AI-generated overview

Lets an assistant browse, search, download, upload and organize a Google Photos library through a hosted remote endpoint.

What you can do
  • List signed-in Google accounts and check whether the saved session still works
  • Page through the library timeline or search it by text, person, place or thing, and read full metadata for one item
  • Download thumbnails or original files to a local folder, and upload local photos or videos in resumable chunks
  • List, create and fill albums, and remove items from albums
  • Mark favorites, archive or unarchive, and move items to Trash
  • Start a Google Photos sign-in when needed and inspect or change the network identity used for requests
When to use it
Useful when you want to find, inspect, download or tidy up photos and videos in a Google Photos account from chat, or to upload local media and sort it into albums without opening the web interface.
Requirements
A remote streamable HTTP endpoint; no package or environment variables are declared. It relies on a saved Google Photos browser session, which the user may need to establish through the sign-in tool, and on the signed-in Google account that holds the photos.
Before you install
It acts on a real Google Photos account: album changes, favorites, archiving, uploads and Trash moves all modify data, and Trash moves are recoverable for 60 days but still remove items from the grid. Reconnecting with force can wipe the saved cookie, and changing the network identity may force a new sign-in. Downloads and uploads move personal media through the hosted service.

Installation

In SourceWeft

  1. Open Google Photos MCP by Nova (CIVAI) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/co.civai.nova%2Fmcp-google_photos/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "google-photos-by-nova-civai": {
      "type": "http",
      "url": "https://nova.civai.co/mcp/agents/mcp-google_photos"
    }
  }
}

Tools

17

list_accounts

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

Parametersnotification_message

list_media

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.

Parametersafterbeforepage_sizemedia_typepage_tokengoogle_account_emailrequirednotification_message

search_media

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.

Parametersqueryrequiredpage_sizepage_tokengoogle_account_emailrequirednotification_message

get_media

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).

Parametersmedia_keyrequiredgoogle_account_emailrequirednotification_message

download_media

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.

Parameterssizemedia_keyrequiredoutput_dirreturn_base64google_account_emailrequirednotification_message

list_albums

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

Parametersalbum_keypage_tokengoogle_account_emailrequirednotification_message

create_album

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

Parameterstitlerequiredmedia_keysgoogle_account_emailrequirednotification_message

add_to_album

Add library items to an existing album.

Parametersalbum_keyrequiredmedia_keysrequiredgoogle_account_emailrequirednotification_message

remove_from_album

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

Parametersalbum_keyrequiredmedia_keysalbum_item_keysgoogle_account_emailrequirednotification_message

set_favorite

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

Parametersfavoritemedia_keysrequiredgoogle_account_emailrequirednotification_message

archive_media

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

Parametersarchivemedia_keysrequiredgoogle_account_emailrequirednotification_message

trash_media

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.

Parametersconfirmrequiredmedia_keysrequiredgoogle_account_emailrequirednotification_message

upload_media

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.

Parameterschunk_mbalbum_keyfile_namefile_pathrequiredgoogle_account_emailrequirednotification_message

check_session

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.

Parametersnotification_message

start_browser_auth

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).

Parametersforce_reconnect

get_network_identity

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.

Takes no parameters.

set_network_identity

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.

Parametersresetroutelocalecountrytimezoneuser_agentimpersonateaccept_language

Version history

1
  1. v1.0.0LatestNov 14, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Civai integrations