Gmail (domdomegg) MCP Server

Allow AI systems to read, send, archive, and manage emails via Gmail. Its 40 documented tools cover gmail, message, thread, draft. It runs locally over stdio via the published package.

People connecting email tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-11 · ★ 11 · VERIFIED 2026-08-25

TypeScript servers · how we verify → /methodology

01 · Install Gmail (domdomegg)

before you install - you'll need

Set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, MCP_TRANSPORT before connecting.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license no standard license detected - usage rights unclear; check the repo before commercial use

npm package gmail-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.domdomegg is GitHub-verified and matches the repo owner

03 · What Gmail (domdomegg) can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get user's email address and profile info, get a single message, send an email, and archive (remove from inbox).

Capability map

Tools grouped from the project's README - what Gmail (domdomegg) lets an agent do.

Gmail

34 tools - e.g. Get user's email address and profile info; Search/list messages (consider gmail_threads_list instead); Get a single message

gmail_get_profile · gmail_messages_list · gmail_message_get · gmail_message_send · gmail_message_forward · gmail_message_modify…

Messages

1 tool - e.g. Messages

Messages

Threads

1 tool - e.g. Threads

Threads

Drafts

1 tool - e.g. Drafts

Drafts

Labels

1 tool - e.g. Labels

Labels

Attachments

1 tool - e.g. Attachments

Attachments

Filters

1 tool - e.g. Filters

Filters

Latest releases

v2.4.0 · 2026-07-27

Bump fast-uri from 3.1.3 to 3.1.4 · keep draft_update from detaching reply drafts from their thread · add htmlBody support to draft_create, draft_update, message_send · New Contributors · @berka77 made their first…

v2.3.2 · 2026-07-23

link install-mcp for adding the server to clients · Report the package.json version instead of a hardcoded literal · Bump flatted from 3.3.3 to 3.4.2 · Bump minimatch · Bump rollup from 4.53.3 to 4.59.0 · Bump…

v2.3.1 · 2026-05-25

Add annotations to write tools

04 · Who maintains Gmail (domdomegg)

Gmail is maintained by domdomegg. We track 17 MCP servers from domdomegg - 17 actively maintained, 861 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from domdomegg.

05 · Facts

repository: github.com/domdomegg/gmail-mcp
website: https://github.com/domdomegg/gmail-mcp#readme
category: email - actively maintained as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-07-27)
registry: io.github.domdomegg/gmail-mcp (active, first published 2025-12-10 · 12 versions)
packages: npm:gmail-mcp · npm:gmail-mcp

06 · Gmail (domdomegg) FAQ

Is Gmail (domdomegg) still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-11 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Gmail (domdomegg) do?

With this server connected, an agent can get user's email address and profile info, get a single message, send an email, and archive (remove from inbox).

How do I install Gmail (domdomegg)?

Run `npx -y gmail-mcp`. The README documents 3 environment variables (GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, MCP_TRANSPORT) to set first. Set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, MCP_TRANSPORT before connecting. You can also paste the ready-made client config above.

Does Gmail (domdomegg) run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Gmail (domdomegg)

Alternatives to Gmail (domdomegg)

Maintained email servers if Gmail (domdomegg) isn't the fit.

More email MCP servers · Emailens MCP · GBG Loqate - Reach · Multi Gmail MCP · Hail · Claw Link

More TypeScript MCP servers · Google Contacts · Google Docs · Google Drive · Google Sheets · Open Food Facts · see all