Gmail MCP Server

io.github.mcp-z/mcp-gmail

local only

Gmail runs on your own machine — the client starts it, so there is no endpoint to ping. 83 installs a week from npm.

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

Installs per day peak 36 · avg 13 · -24% w/w

a month agotoday

Installs / week

npm · @mcp-z/mcp-gmail

—

Stars

on GitHub

—

Last commit

0 releases in 90 days

—

License

language unknown

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.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-gmail": {
      "args": [
        "-y",
        "@mcp-z/mcp-gmail"
      ],
      "command": "npx"
    }
  }
}

~/.codex/config.toml

[mcp_servers.mcp-gmail]
command = "npx"
args = ["-y", "@mcp-z/mcp-gmail"]

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-gmail": {
      "args": [
        "-y",
        "@mcp-z/mcp-gmail"
      ],
      "command": "npx"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "mcp-gmail": {
      "args": [
        "-y",
        "@mcp-z/mcp-gmail"
      ],
      "command": "npx"
    }
  }
}

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 @mcp-z/mcp-gmail was installed 83 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 with the file path that client actually reads. It runs locally, so the command pulls @mcp-z/mcp-gmail straight from npm; nothing to host, nothing to sign up for.

How many people use Gmail?

The npm package @mcp-z/mcp-gmail was installed 83 times in the last week. Week over week that is -24%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.