Skip to content

Google Photos

The Google Photos connector indexes album and media-item metadata into the local SQLite index and exposes read tools for listing and searching photos. Read-only — there are no write tools.


  • Service id: google_photos
  • Item types: photo
Terminal window
nimbus connector auth google-photos

OAuth (Google). The Gateway resolves a short-lived access token per service via the per-service Google OAuth flow and injects it into the connector spawn as GOOGLE_OAUTH_ACCESS_TOKEN.

| Tool | Purpose | |---|---| | gphotos_album_get | Get a single album by id (title, mediaItemsCount, coverPhotoBaseUrl). | | gphotos_album_list | List Google Photos albums (metadata). Supports pagination. | | gphotos_media_get | Get a single media item by id. | | gphotos_media_list | List media items (metadata + baseUrl / productUrl only). Optional albumId scopes to one album. | | gphotos_media_search | Search media items. Optional album filter; supports pagination. |

No write tools — this connector is read-only.