Best Claude Apps

In Claude’s connector directory

Gmail MCP server

Yes. Google provides a remote MCP server, listed in Claude’s connector directory with the Anthropic verified mark. You sign in with your Gmail account in the browser, so there is no API key to paste.

Maintained by
Google
Sign-in
Gmail account no API key
Tools
29 6 read · 16 write
Community servers
9 by third parties in the MCP Registry
Docs
developers.google.com
Transport
Streamable HTTP

Where the Gmail server is listed

01Setup

How to connect the Gmail MCP server

Every client below points at the same URL. Pick yours.

Claude (web, desktop and mobile)

  1. 1 Click Add to Claude, or open Settings → Connectors → Browse connectors and search for Gmail.
  2. 2 Click Connect. Sign in to Gmail and approve the access it asks for.
  3. 3 In a chat, open the tools menu under the message box and check Gmail is on.

Tool-by-tool permissions, security notes and reviews: Gmail connector for Claude.

Claude Code

  1. 1
    Run this in your terminal: 
    claude mcp add --transport http gmail https://gmailmcp.googleapis.com/mcp/v1
    Add --scope user to use it in every project, or --scope project to share it through .mcp.json.
  2. 2 Start Claude Code, type /mcp, pick gmail and sign in to Gmail in the browser.
  3. 3 Check it with claude mcp list.

ChatGPT

We found no Gmail plugin in ChatGPT’s directory. ChatGPT plans that allow custom connectors (developer mode) can add the server by URL in settings.

Cursor

Add to Cursor

One click if the app is installed, or add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project) , then check it under Settings → MCP.

~/.cursor/mcp.json 
{
  "mcpServers": {
    "gmail": {
      "url": "https://gmailmcp.googleapis.com/mcp/v1"
    }
  }
}

VS Code

Add to VS Code

One click if the app is installed, or add this to .vscode/mcp.json in your project , then start the server from the file or the MCP view. It is used by Copilot agent mode.

.vscode/mcp.json 
{
  "servers": {
    "gmail": {
      "type": "http",
      "url": "https://gmailmcp.googleapis.com/mcp/v1"
    }
  }
}

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json , then refresh the MCP list in Cascade.

~/.codeium/windsurf/mcp_config.json 
{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1"
    }
  }
}

Codex CLI

Add this to ~/.codex/config.toml , then restart Codex.

~/.codex/config.toml 
[mcp_servers.gmail]
url = "https://gmailmcp.googleapis.com/mcp/v1"
Where it runs
On Gmail’s side, at gmailmcp.googleapis.com. Nothing is installed on your machine.
Sign-in
Each person signs in with their own Gmail account in the browser. The client gets that account’s access, nothing more.
Client only runs local servers?
Bridge to the remote URL with mcp-remote: npx mcp-remote https://gmailmcp.googleapis.com/mcp/v1

02Capabilities

What the Gmail MCP server can do

Summarised from the 29 tools in Gmail’s listing: what an AI client can read, and what it can change.

Reads
Labels, Message, Threads, Drafts, Filters, Forward, Unlabel message, Unlabel thread, Unmark message spam, Unmark thread spam, Untrash message, Untrash thread
Changes
Create and update labels and drafts; label and send message; label threads; create filters; reply account; mark message spam and thread spam; apply sensitive message label and sensitive thread label.
Deletes
Delete labels; Trash message and threads.

Gmail’s own one-liner: “Draft replies, summarize threads, & search your inbox” (Claude directory listing)

03Tools

Gmail MCP tools

All 29 tools an AI client can call once connected: 13 read, 16 create or change (3 delete).

Labels 4 list_labels create_label update_label delete_label
Message 4 get_message label_message send_message trash_message
Threads 4 get_thread search_threads label_thread trash_thread
Drafts 3 list_drafts create_draft update_draft
Filters 2 list_filters create_filter
Account 1 reply
Forward 1 forward
Message spam 1 mark_message_spam
Sensitive message label 1 apply_sensitive_message_label
Sensitive thread label 1 apply_sensitive_thread_label
Thread spam 1 mark_thread_spam
Unlabel message 1 unlabel_message
Unlabel thread 1 unlabel_thread
Unmark message spam 1 unmark_message_spam
Unmark thread spam 1 unmark_thread_spam
Untrash message 1 untrash_message
Untrash thread 1 untrash_thread

Tool names from Gmail’s listing in Claude’s connector directory, checked 2026-10-20. Read and write labels are our reading of each name’s verb. In Claude you can set each tool to ask before it runs.

04Servers

Official vs community Gmail MCP servers

10 servers for Gmail in the official MCP Registry and Claude’s connector directory. “Official” means the registry entry is tied to google.com or Gmail’s own GitHub account; community servers are built by anyone else.

  • Claude directory Gmail by Google

    Draft replies, summarize threads, & search your inbox

    Remote · gmailmcp.googleapis.com · 29 tools

  • Community Gmail v2.3.3

    Gmail integration with OAuth authentication, message search, batch operations, and Sheets export

    Runs
    Local · npm @mcp-z/mcp-gmail
    Registry
    io.github.mcp-z/mcp-gmail
    Published
    Oct 2026
    Config for this server

    Claude Code

    claude mcp add gmail -- npx -y @mcp-z/mcp-gmail

    Cursor, Windsurf, Claude Desktop (mcpServers)

    {
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-z/mcp-gmail"
      ]
    }
  }
}
  • Community Gmail v0.1.2

    Gmail MCP Pack

    Runs
    Remote gateway.pipeworx.io
    Registry
    io.github.pipeworx-io/gmail
    Published
    Sep 2026
    Source
    pipeworx-io/mcp-gmail
    Config for this server

    Claude Code

    claude mcp add --transport http gmail https://gateway.pipeworx.io/gmail/mcp

    Cursor, Windsurf, Claude Desktop (mcpServers)

    {
  "mcpServers": {
    "gmail": {
      "url": "https://gateway.pipeworx.io/gmail/mcp"
    }
  }
}
  • Community Gmail MCP v1.0.0

    MCP server for the Gmail API: search, read and send email, manage drafts, labels and the trash.

    Runs
    Local · npm mcp-google-gmail
    Registry
    io.github.A1-x-Tech/mcp-google-gmail
    Published
    Sep 2026
    Source
    A1-x-Tech/mcp-google-gmail
    Config for this server

    Claude Code

    claude mcp add gmail -- npx -y mcp-google-gmail

    Cursor, Windsurf, Claude Desktop (mcpServers)

    {
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-gmail"
      ]
    }
  }
}
  • Community gmail v0.4.12

    MCP server for Gmail with OAuth2 (personal) and service account (Workspace) support.

    Runs
    Local · npm gmail-workspace-mcp-server
    Registry
    com.pulsemcp/gmail
    Published
    Aug 2026
    Source
    pulsemcp/mcp-servers
    Config for this server

    Claude Code

    claude mcp add gmail -- npx -y gmail-workspace-mcp-server

    Cursor, Windsurf, Claude Desktop (mcpServers)

    {
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-workspace-mcp-server"
      ]
    }
  }
}
  • Community Gmail v2.4.0

    Allow AI systems to read, send, archive, and manage emails via Gmail.

    Runs
    Local · npm gmail-mcp
    Registry
    io.github.domdomegg/gmail-mcp
    Published
    Jul 2026
    Source
    domdomegg/gmail-mcp.git
    Config for this server

    Claude Code

    claude mcp add gmail -- npx -y gmail-mcp

    Cursor, Windsurf, Claude Desktop (mcpServers)

    {
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp"
      ]
    }
  }
}
  • Community Gmail-MCP-Server v1.2.3

    Lean Gmail MCP server with auto authentication support

    Runs
    Local · npm @artymclabin/gmail-mcp
    Registry
    io.github.ArtyMcLabin/Gmail-MCP-Server
    Published
    Jul 2026
    Source
    ArtyMcLabin/Gmail-MCP-Server
    Config for this server

    Claude Code

    claude mcp add gmail -- npx -y @artymclabin/gmail-mcp

    Cursor, Windsurf, Claude Desktop (mcpServers)

    {
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@artymclabin/gmail-mcp"
      ]
    }
  }
}
  • Community gmail v0.1.0

    Gmail MCP server — send, read, and search email. By Strider Labs.

    Runs
    Local · npm @striderlabs/mcp-gmail
    Registry
    io.github.markswendsen-code/gmail
    Published
    Mar 2026
    Source
    markswendsen-code/mcp-gmail
    Config for this server

    Claude Code

    claude mcp add gmail -- npx -y @striderlabs/mcp-gmail

    Cursor, Windsurf, Claude Desktop (mcpServers)

    {
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@striderlabs/mcp-gmail"
      ]
    }
  }
}
  • Community gmail v1.0.5

    A MCP server for Gmail that lets you search, read, and draft emails and replies.

    Runs
    Remote gmail.mintmcp.com
    Registry
    com.mintmcp/gmail
    Published
    Sep 2025
    Source
    mintmcp/servers
    Config for this server

    Claude Code

    claude mcp add --transport http gmail https://gmail.mintmcp.com/mcp

    Cursor, Windsurf, Claude Desktop (mcpServers)

    {
  "mcpServers": {
    "gmail": {
      "url": "https://gmail.mintmcp.com/mcp"
    }
  }
}
  • Community gmail v0.3.1

    Read emails, send messages, and manage labels in your Gmail account.

    Runs
    Remote waystation.ai
    Registry
    ai.waystation/gmail
    Published
    Sep 2025
    Source
    waystation-ai/mcp
    Config for this server

    Claude Code

    claude mcp add --transport http gmail https://waystation.ai/gmail/mcp

    Cursor, Windsurf, Claude Desktop (mcpServers)

    {
  "mcpServers": {
    "gmail": {
      "url": "https://waystation.ai/gmail/mcp"
    }
  }
}

05FAQ

Gmail MCP questions

Is there an official Gmail MCP server?

Yes. Google provides a remote MCP server at https://gmailmcp.googleapis.com/mcp/v1, listed in Claude’s connector directory with the Anthropic verified mark. You sign in with your Gmail account in the browser; there is no API key to paste. It exposes 29 tools: 6 read and 16 write.

What is the Gmail MCP server URL?

https://gmailmcp.googleapis.com/mcp/v1. It is a remote MCP server over streamable HTTP, hosted at gmailmcp.googleapis.com. Paste it into any client that supports remote MCP servers.

How do I add the Gmail MCP server to Claude Code?

Run: claude mcp add --transport http gmail https://gmailmcp.googleapis.com/mcp/v1. Then start Claude Code, type /mcp, choose gmail and sign in to Gmail. Add --scope user to make it available in every project.

How do I use the Gmail MCP server in Cursor or VS Code?

In Cursor, add it to ~/.cursor/mcp.json under "mcpServers" as {"gmail": {"url": "https://gmailmcp.googleapis.com/mcp/v1"}}. In VS Code, add it to .vscode/mcp.json under "servers" with "type": "http" and the same URL. Both apps also accept the one-click install links on this page.

Does the Gmail MCP server need an API key?

No key to copy. You sign in to your Gmail account in the browser when you first connect, and the client acts with that account’s access.

What tools does the Gmail MCP server have?

29 tools: apply_sensitive_message_label, apply_sensitive_thread_label, create_draft, create_filter, create_label, delete_label, forward, get_message, get_thread, label_message, label_thread, list_drafts, list_filters, list_labels, mark_message_spam, mark_thread_spam, reply, search_threads, send_message, trash_message, trash_thread, unlabel_message, unlabel_thread, unmark_message_spam, unmark_thread_spam, untrash_message, untrash_thread, update_draft, update_label.

Does Gmail work in ChatGPT?

We found no Gmail plugin in ChatGPT’s directory. Plans that allow custom connectors can add the server by URL.

Should I use an official or a community Gmail MCP server?

Start with the directory server: it is run by Google. The 9 community servers are built by third parties; remote ones route your data through their own hosts and local ones usually need an API key.

Sources: the official MCP Registry, Gmail in Claude’s connector directory , checked October 20, 2026. Client config formats follow each client’s own docs. This site is independent and not affiliated with Gmail, Anthropic or OpenAI. See also the Gmail connector page for reviews.

Loading…

Browse all connectors →