How to connect Gmail to Claude

Connect Claude Web, Desktop and Cowork to Gmail MCP. Summarize unread emails from this morning, create draft replies to urgent messages, and more using natural language, with authentication handled for you.

Gmail logoGmail
Oauth2

Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.

61 Tools2 Triggers

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 Gmail account to Claude via Composio Connect, enabling it to summarize unread emails from this morning, create draft replies to urgent messages, fetch contact details for recent senders, 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.

You can also connect Claude to multiple Gmail accounts with Composio.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Gmail with

Connecting Gmail 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 Gmail account

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

For example, ask Claude to:

  • "Summarize unread emails from this morning"
  • "Create draft replies to urgent messages"
  • "Fetch contact details for recent senders"

It will prompt you to authenticate and authorize access.

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

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

The Gmail MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Gmail account. It provides structured and secure access to your email, drafts, attachments, labels, and contacts, so your agent can read messages, send emails, manage drafts, organize your inbox, and handle conversations on your behalf.

  • Email search and reading: Instruct your agent to find emails using filters, read complete messages, and retrieve specific attachments.
  • Drafting and sending: Have your agent create, update, review, send, or delete drafts, and send new emails from your Gmail account.
  • Replies and conversation management: Let the agent reply within existing email threads and move conversations to or from the trash.
  • Inbox and label organization: Direct your agent to modify labels across multiple messages and update the properties of existing Gmail labels.
  • Contact and account lookup: Have your agent search contacts by personal or workplace details and identify the connected Gmail account.

Troubleshooting

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

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

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

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

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

  • 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 Gmail.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Gmail authorization link not work?

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

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

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

The Gmail connection can expire or lose permission.

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

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

Claude can manage the Gmail connection for you.

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

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

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

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Gmail 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 Gmail.
TOOLS & TRIGGERS

Supported Tools and Triggers

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

Modify email labels

Adds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid (use 'listLabels' for custom label IDs).

Batch delete Gmail messages

Permanently deletes multiple Gmail messages by ID, bypassing Trash.

Batch modify Gmail messages

Adds or removes labels on up to 1,000 Gmail messages in one request, supporting operations such as archiving and marking messages read or unread.

Create email draft

Creates a Gmail draft with optional recipients, subject, plain or HTML body, attachments, and threading.

Create Gmail filter

Tool to create a new Gmail filter with specified criteria and actions.

Create label

Creates a Gmail label and returns its label ID.

Delete Draft

Permanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling.

Delete Gmail filter

Tool to permanently delete a Gmail filter by its ID.

Delete label from account (permanent)

Permanently DELETES a user-created Gmail label from the account (not from a message).

Delete message

Permanently deletes a specific email message by its ID from a Gmail mailbox; for `user_id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access.

Delete thread

Tool to immediately and permanently delete a specified thread and all its messages.

Fetch emails

Lists Gmail messages with query and label filtering, pagination, and optional message details.

Fetch message by message ID

Fetches a Gmail message by its message ID in the requested format and returns formatted message details.

Fetch Message by Thread ID

Retrieves messages from an accessible Gmail thread by thread ID, returning thread details and a messages array.

Forward email message

Forwards an existing Gmail message to specified recipients, with optional additional text.

Get Gmail attachment

Retrieves a Gmail message attachment by message and attachment IDs and returns a downloadable file using the supplied filename.

Get Auto-Forwarding Settings

Tool to get the auto-forwarding setting for the specified account.

Get contacts

Lists saved Google contacts with selectable fields and pagination, optionally including Other Contacts.

Get Draft

Retrieves a single Gmail draft by its ID.

Get Gmail filter

Tool to retrieve a specific Gmail filter by its ID.

Get label details

Gets details for a specified Gmail label.

Get Language Settings

Tool to retrieve the language settings for a Gmail user.

Get People

Retrieves a person's details by resource name or lists the authenticated user's Other Contacts, using a field mask to select the information returned.

Get Profile

Retrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user.

Get Vacation Settings

Tool to retrieve vacation responder settings for a Gmail user.

Import message

Tool to import a message into the user's mailbox with standard email delivery scanning and classification.

Insert message into mailbox

Tool to insert a message into the user's mailbox similar to IMAP APPEND.

List CSE identities

Lists a page of client-side encrypted identities and their key-pair associations.

List CSE key pairs

Lists a page of client-side encryption key pairs, including public keys and enablement states.

List Drafts

Retrieves a paginated list of email drafts from a user's Gmail account.

List Gmail filters

Tool to list all Gmail filters (rules) in the mailbox.

List forwarding addresses

Tool to list all forwarding addresses for the specified Gmail account.

List Gmail history

Lists Gmail mailbox change history since a known history ID for incremental sync, with optional label and history-type filters and pagination.

List Gmail labels

Retrieves all system and user-created labels for a Gmail account in a single unpaginated response.

List send-as aliases

Lists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases.

List S/MIME configs

Lists S/MIME certificate configurations for a specified Gmail send-as alias.

List threads

Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination.

Modify thread labels

Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid.

Trash thread

Moves the specified thread to the trash.

Move to Trash

Moves an existing, non-deleted email message to the trash for the specified user.

Patch Label

Patches the specified user-created label.

Patch send-as alias

Patches a Gmail send-as alias, including its display name, reply-to address, signature, default status, or SMTP configuration.

Reply to email thread

Sends a reply to a Gmail thread using its original subject and quoting the last returned message.

Search People

Searches saved contacts and optionally Other Contacts by query, returning matching person records.

Send Draft

Sends an existing Gmail draft immediately to the recipients already in its To, Cc, and Bcc headers.

Send Email

Sends an email immediately through Gmail to specified To, Cc, or Bcc recipients, with a subject or body and optional attachments.

Get IMAP Settings

Retrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size.

Get POP settings

Tool to retrieve POP settings for a Gmail account.

Get send-as alias

Tool to retrieve a specific send-as alias configuration for a Gmail user.

Stop watch notifications

Tool to stop receiving push notifications for a Gmail mailbox.

Untrash Message

Tool to remove a message from trash in Gmail.

Untrash thread

Tool to remove a thread from trash in Gmail.

Update Google Contact

Replace selected fields on an existing saved Google contact.

Update draft

Updates a Gmail draft by ID by replacing its message.

Update IMAP settings

Tool to update IMAP settings for a Gmail account.

Update Label

Updates an existing Gmail label's name, visibility settings, or color to help organize the mailbox.

Update Language Settings

Tool to update the language settings for a Gmail user.

Update POP settings

Tool to update POP settings for a Gmail account.

Update send-as alias

Updates a Gmail send-as alias, including its display name, signature, reply-to address, or SMTP settings; Gmail sanitizes HTML signatures before saving.

Update Vacation Settings

Tool to update vacation responder settings for a Gmail user.

Who Am I

Return the identity (email, name) of the connected Gmail account.

FAQ

Frequently asked questions

Start with Gmail.It takes 30 seconds.

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

Start building