Gmail MCP Server: Install & Setup

Install Gmail in Claude Code

Claude Code

claude mcp add domdomegg-gmail -e GOOGLE_ACCESS_TOKEN=... -- npx -y gmail-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "domdomegg-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp"
      ],
      "env": {
        "GOOGLE_ACCESS_TOKEN": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Gmail MCP server do?

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

Is the Gmail MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does Gmail run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Gmail to Claude Code?

Run: claude mcp add domdomegg-gmail -e GOOGLE_ACCESS_TOKEN=... -- npx -y gmail-mcp

More communication MCP servers

View all

Inbox Zero

13k

elie222/inbox-zero

Inbox Zero features on top of Gmail, such as finding emails that need a reply or follow-up.

RemoteAccount neededTypeScript

6.8k

lharries/whatsapp-mcp

Search personal WhatsApp messages and contacts, and send messages to individuals or groups.

LocalFreePython

draw.io

5.7k

jgraph/drawio-mcp

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

RemoteAccount needed

Vexa

2.9k

Vexa-ai/vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

RemoteAccount needed

1.9k

chigwell/telegram-mcp

Telegram API integration: access user data, manage dialogs (chats, channels, groups), retrieve and send messages, and handle read status.