How to connect Googlephotos to Claude

Connect Claude Web, Desktop and Cowork to Googlephotos MCP. Find all photos from your last vacation, create a new album for 2024 events, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Googlephotos

Oauth2

Google Photos is a cloud-based photo storage and organization service by Google. It offers automatic backups, smart search, and seamless sharing for managing your media library.

13 Tools

Managed auth

Connect Googlephotos without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Googlephotos account to Claude via Composio Connect, enabling it to find all photos from your last vacation, create a new album for 2024 events, upload these images to your family album, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Googlephotos with

Connecting Googlephotos to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash

https://connect.composio.dev/mcp

Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Googlephotos account

Back in Claude, ask it to connect to Googlephotos or give it any Googlephotos-related task.

For example, ask Claude to:

"Find all photos from your last vacation"
"Create a new album for 2024 events"
"Upload these images to your family album"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Googlephotos account is ready to use.

What is the Googlephotos Claude Connector, and what's possible with it?

The Googlephotos MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google Photos account. It provides structured and secure access to your photo library, so your agent can organize albums, upload and manage media items, search your photos, and even download images on your behalf.

Effortless media uploads and organization: Instantly upload new photos or videos, add them to existing albums, and create new albums for specific events or trips—all through your AI agent.
Smart album and library management: List all your albums or fetch details for any album, making it simple for the agent to help you organize or locate collections of photos.
AI-powered photo search: Ask your agent to search your photo library using keywords, dates, or other criteria to quickly find specific images or memories.
Bulk media handling: Retrieve batches of photos or videos, add multiple media items to albums at once, or download images as files for sharing or backup.
Enhanced photo enrichment: Automatically enhance your albums by adding context, locations, or notes at specific positions—helping you curate richer stories from your memories.

Troubleshooting

1. Why does Claude not use the Composio connector for Googlephotos?

The connector can show as connected, but Claude must use it in each Googlephotos conversation.

Click + at the lower left of the chat, or type /.
Hover Connectors.
Turn on Composio.
Ask Claude to connect to Googlephotos again.

2. Why does Claude show an MCP server error before Googlephotos connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Googlephotos.

Check that the connector URL is https://connect.composio.dev/mcp.
Connectors run from Anthropic's cloud, so your device network is usually not the problem.
Add the connector again from Customize > Connectors, then ask Claude to connect Googlephotos.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Googlephotos authorization link not work?

The Composio connector is one server. Your Googlephotos account connects separately when Claude asks for it.

If the browser does not open, or the link expires, ask Claude to retry the Googlephotos connection.
Composio creates a fresh Googlephotos authorization link.
Open that link in your browser and finish the Googlephotos sign-in.

4. Why do Googlephotos actions fail after they worked before?

The Googlephotos connection can expire or lose permission.

Ask Claude to inspect the Googlephotos connection.
If the connection is unhealthy, disconnect it when Claude prompts you.
Reconnect the Googlephotos account and retry the action.
If Claude shows a permission prompt, approve it before Claude changes data in Googlephotos.
If the action still fails with a permission error, check that the connected account has that permission in Googlephotos itself.

5. How do I switch to a different Googlephotos account?

Claude can manage the Googlephotos connection for you.

Ask Claude to disconnect or delete the current Googlephotos account.
Ask Claude to connect Googlephotos again.
Open the new Composio authorization link for Googlephotos.
Sign in with the other Googlephotos account in the browser.
After the account connects, ask Claude to retry the Googlephotos task.

6. Why is my Googlephotos connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Googlephotos connection works in Claude Web, Desktop, and Cowork.

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If Googlephotos tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Googlephotos.

TOOLS

Supported Tools

Every Googlephotos action and event your agent gets out of the box.

Add Enrichment

Adds an enrichment at a specified position in a defined album.

Batch Add Media Items

Adds one or more media items to an album in Google Photos.

Batch Create Media Items

Batch upload and create media items in Google Photos.

Batch Get Media Items

Returns the list of media items for the specified media item identifiers.

Create Album

Creates a new album in Google Photos.

Get Album

Returns the album based on the specified albumId.

Download Photos Media Item

Downloads a media item from Google Photos and returns it as a file.

List Albums

Lists all albums shown to a user in the Albums tab of Google Photos.

List Media Items (App-Created Only)

Lists media items created by this application from Google Photos.

Search Media Items

Searches for media items in a user's Google Photos library.

Update Album

Updates an album's title or cover photo in Google Photos.

Update Media Item

Updates a media item's description in Google Photos.

Upload Media

Upload a media file to Google Photos.

FRAMEWORKS

How to build Googlephotos MCP Agent with another framework

Claude Code

Use Googlephotos MCP with Claude Code

Cursor

Use Googlephotos MCP with Cursor

ChatGPT

Use Googlephotos MCP with ChatGPT

Antigravity

Use Googlephotos MCP with Antigravity

OpenAI Agents SDK

Use Googlephotos MCP with OpenAI Agents SDK

Claude Agent SDK

Use Googlephotos MCP with Claude Agent SDK

Grok Bot

Use Googlephotos MCP with Grok Bot

Codex

Use Googlephotos MCP with Codex

Grok Build

Use Googlephotos MCP with Grok Build

VS Code

Use Googlephotos MCP with VS Code

OpenCode

Use Googlephotos MCP with OpenCode

OpenClaw

Use Googlephotos MCP with OpenClaw

Hermes

Use Googlephotos MCP with Hermes

Atomic Agent

Use Googlephotos MCP with Atomic Agent

Google ADK

Use Googlephotos MCP with Google ADK

LangChain

Use Googlephotos MCP with LangChain

Vercel AI SDK

Use Googlephotos MCP with Vercel AI SDK

Mastra AI

Use Googlephotos MCP with Mastra AI

LlamaIndex

Use Googlephotos MCP with LlamaIndex

CrewAI

Use Googlephotos MCP with CrewAI

Pydantic AI

Use Googlephotos MCP with Pydantic AI

AutoGen

Use Googlephotos MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Google Drive

Oauth2

Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices.

Google Docs

Oauth2

Google Docs is a cloud-based word processor that enables document creation and real-time collaboration. Its seamless sharing and version history make team editing and content management a breeze.

Google Super

Oauth2Api Key

Google Super is an all-in-one suite combining Gmail, Drive, Calendar, Sheets, Analytics, and more. It gives you a unified platform to manage your digital life, boosting productivity and organization.

ActiveMerge

Api Key

ActiveMerge is a document automation platform for generating documents, images, merged files, and e-signature workflows. It helps teams turn templates and stored files into finished, shareable documents faster.

FAQ

Frequently asked questions

With a standalone Googlephotos MCP server, the agents and LLMs can only access a fixed set of Googlephotos tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Googlephotos and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Googlephotos tools.

Yes, absolutely. You can configure which Googlephotos scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Googlephotos data and credentials are handled as safely as possible.

Start with Googlephotos.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Googlephotos tool your agent needs.Free to start.

Start building

How to connect Googlephotos to Claude

Connect Googlephotos without auth hassles

Introduction

Also integrate Googlephotos with

Connecting Googlephotos to Claude Web, Desktop, and Cowork

1. Add with one click

Add manually

2. Authorize in your browser

3. Connect your Googlephotos account

What is the Googlephotos Claude Connector, and what's possible with it?

Troubleshooting

1. Why does Claude not use the Composio connector for Googlephotos?

2. Why does Claude show an MCP server error before Googlephotos connects?

3. Why does the Googlephotos authorization link not work?

4. Why do Googlephotos actions fail after they worked before?

5. How do I switch to a different Googlephotos account?

6. Why is my Googlephotos connection missing in Claude Desktop or on a Team plan?

Supported Tools

How to build Googlephotos MCP Agent with another framework

Claude Code

Cursor

ChatGPT

Antigravity

OpenAI Agents SDK

Claude Agent SDK

Grok Bot

Codex

Grok Build

VS Code

OpenCode

OpenClaw

Hermes

Atomic Agent

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Google Drive

Google Docs

Google Super

ActiveMerge

Frequently asked questions

What are the differences in Tool Router MCP and Googlephotos MCP?+

Can I use Tool Router MCP with Claude Cowork?+

Can I manage the permissions and scopes for Googlephotos while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Googlephotos.It takes 30 seconds.