mcpbeat Sign in

Gmail MCP Server

local only

Gmail runs on your own machine — the client starts it, so there is no endpoint to ping. 371 installs a week from npm. Last commit 25 Oct 2026.

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

Installs per day peak 2 136 · avg 104 · +1406% w/w
a month agotoday
371
Installs / week
npm · gmail-mcp
12
Stars
3 open issues
25 Oct 2026
Last commit
1 release in 90 days
MIT
License
TypeScript

Nothing serious here today

Today is the operative word: we check Gmail every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add gmail-mcp -e 'MCP_TRANSPORT=<MCP_TRANSPORT>' -e 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' -e 'GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET>' -- npx -y gmail-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "gmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.gmail-mcp]
command = "npx"
args = ["-y", "gmail-mcp"]
env = { MCP_TRANSPORT = "<MCP_TRANSPORT>", GOOGLE_CLIENT_ID = "<GOOGLE_CLIENT_ID>", GOOGLE_CLIENT_SECRET = "<GOOGLE_CLIENT_SECRET>" }
.cursor/mcp.json
{
  "mcpServers": {
    "gmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "gmail-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}

Put your own values in place of <MCP_TRANSPORT> (Transport type), <GOOGLE_CLIENT_ID> (Google OAuth client ID), <GOOGLE_CLIENT_SECRET> (Google OAuth client secret). The author’s registry entry marks them as required.

Alternatives to Gmail

same job, measured the same way
Email2Chat
by bayramcsb

Connect Claude to your Gmail and Outlook inbox. Read, search, and manage emails via AI.

101 installs/wk local only
Maylee
by maylee

Maylee AI email: read, search, triage, draft and send; manage labels, views and AI label rules.

answering
Mail.app
by p-l-ta

Search, read, send, and manage email via macOS Mail.app across all configured accounts.

93 installs/wk local only
Gmail
by waystation

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

answering
Apple Mail
by jonathanrreed

Read, search, compose, and send emails via Apple Mail on macOS.

954 installs/wk local only
Gmail MCP
by a1-x-tech

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

80 installs/wk local only
Qmailing
by qmailing

AI agents read & send email, manage mailboxes, domains and webhooks via the QMailing API.

81 installs/wk answering
AgentMail
by agentmail

Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.

answering

Gmail — questions

Answers built from our own checks of this server.

Why is there no uptime for Gmail?
Gmail runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package gmail-mcp was installed 371 times last week.
How do I connect Gmail?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls gmail-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Gmail?
The npm package gmail-mcp was installed 371 times in the last week. Week over week that is +1406%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Gmail open source?
Yes — it is published under the MIT licence, written in TypeScript, 12 stars on GitHub and 3 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.