Google Photos MCP by Nova (CIVAI)

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.

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.

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.

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

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.

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

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

Add library items to an existing album.

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

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

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

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.

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.

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.

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

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.

无需输入参数。

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.