mcpbeat Sign in

Gmail MCP Server

local only

Gmail MCP runs on your own machine — the client starts it, so there is no endpoint to ping.

Gmail MCP server: list, read, search and send email, manage drafts and labels.

—
Installs / week
npm · @renzo.johnson/gmail-mcp
—
Stars
on GitHub
—
Last commit
from GitHub
—
License
language unknown

Nothing serious here today

Today is the operative word: we check Gmail MCP 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 -- npx -y @renzo.johnson/gmail-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "gmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/gmail-mcp"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.gmail-mcp]
command = "npx"
args = ["-y", "@renzo.johnson/gmail-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "gmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/gmail-mcp"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "gmail-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/gmail-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: GOOGLE_APPLICATION_CREDENTIALS (Path to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables), GOOGLE_OAUTH_CLIENT_ID (OAuth client ID. Set together with the client secret and refresh token), GOOGLE_OAUTH_CLIENT_SECRET (OAuth client secret), GOOGLE_OAUTH_REFRESH_TOKEN (OAuth refresh token with the Gmail scopes).

Alternatives to Gmail MCP

same job, measured the same way
Gmail MCP
by a1-x-tech

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

231 installs/wk local only
Gmail
by markswendsen-code

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

35 installs/wk local only
Mailbox MCP
by jgalea

Multi-account email MCP server for Gmail, IMAP, and JMAP: search, send, drafts, labels.

154 installs/wk local only
Maylee
by maylee

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

answering
Google Gmail
by mcparmory

Send, read, organize emails, manage labels, drafts, and filters

272 installs/wk local only
Gmail
by mintmcp

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

answering
Multi-Account Gmail
by cunicopia-dev

Multi-account Gmail MCP server — read, search, draft, and label across every inbox.

265 installs/wk local only
Google Mail MCP
by mmedum

Gmail over MCP from your own account: search, read threads and messages, labels and drafts.

local only

Gmail MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Gmail MCP?
Gmail MCP 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 @renzo.johnson/gmail-mcp.
How do I connect Gmail MCP?
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 @renzo.johnson/gmail-mcp straight from npm; nothing to host, nothing to sign up for.