Gmail

Name: Gmail
Author: mcp-z

Community

MCP server by mcp-z · updated 11 days ago · 2.8k downloads a week

Score 51

Gmail integration with OAuth authentication, message search, batch operations, and Sheets export Gmail is a community project by mcp-z, not verified by a company domain.

Install Add to Cursor Add to VS Code Website

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Licence

No licence found, so reuse rights are unclear

Quality

Clear description, published package or server URL, original repository

Security

Not checked yet. What we check

What you need

Setting	Needed	What it is
`GOOGLE_CLIENT_ID`Environment variable	Required	Google OAuth client ID (required for OAuth authentication modes)
`GOOGLE_CLIENT_SECRET`Environment variable, secret	Optional	Google OAuth client secret (optional for public clients)
`GOOGLE_SERVICE_ACCOUNT_KEY_FILE`Environment variable	Optional	Path to service account JSON key file (required for service-account auth mode)
`AUTH_MODE`Environment variable	Optional	Authentication mode
`HEADLESS`Environment variable	Optional	Disable browser auto-open, return auth URL instead (true/false) Default: `false`
`REDIRECT_URI`Environment variable	Optional	OAuth redirect URI (optional, default: ephemeral loopback)
`RESOURCE_STORE_URI`Environment variable	Optional	Resource store URI for CSV export files (file://)
`PORT`Environment variable	Optional	HTTP server port (overrides --port)
`BASE_URL`Environment variable	Optional	Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)
`LOG_LEVEL`Environment variable	Optional	Logging level

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install Gmail

Built from the published package, never by AI

claude mcp add gmail -e GOOGLE_CLIENT_ID=123456789-abcdefghijk.apps.googleusercontent.com -- npx -y @mcp-z/mcp-gmail

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install Gmail in Claude Code

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-z/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "123456789-abcdefghijk.apps.googleusercontent.com"
      }
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install Gmail in Claude Desktop

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-z/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "123456789-abcdefghijk.apps.googleusercontent.com"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install Gmail in Cursor

{
  "servers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-z/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "123456789-abcdefghijk.apps.googleusercontent.com"
      }
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install Gmail in VS Code

codex mcp add gmail --env GOOGLE_CLIENT_ID=123456789-abcdefghijk.apps.googleusercontent.com -- npx -y @mcp-z/mcp-gmail

Step-by-step: install Gmail in Codex

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-z/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "123456789-abcdefghijk.apps.googleusercontent.com"
      }
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install Gmail in Antigravity CLI

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

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install Gmail in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the gmail block.

Weekly newsletter

Like Gmail? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Alternatives to Gmail

All alternatives →

OpenWork MCP Gateway different-ai

Your OpenWork org's skills, plugins, workflows, and connections through one OAuth MCP URL.

AFA Remote 24k

Modelcontextprotocol Core modelcontextprotocol

Model Context Protocol for TypeScript — public Zod schemas (spec + OAuth/OpenID) (with updated dependencies)

AAA Local 14k

Agents MCP electric-sql

Model Context Protocol registry, transports, and OAuth bridges for Electric Agents

AAA Local 10k

MCP Remote punkpeye

Remote proxy for Model Context Protocol, allowing local-only clients to connect to remote servers using oAuth

AAA Local 505k/wk

Agentmesh MCP Proxy microsoft

Public Preview — Security proxy for MCP servers: The Firewall for Model Context Protocol

AAA Local 6.5k

NotFairnowork-studio

OAuth MCP for Google, Meta, X, LinkedIn, Reddit, TikTok, GSC, GA4, WordPress and GHL.

AAA Remote 4.0k

Gmail vs OpenWork MCP Gateway Gmail vs Modelcontextprotocol Core Gmail vs Agents MCP

Gmail: common questions

How do I install Gmail?

In Claude Code run claude mcp add gmail -e GOOGLE_CLIENT_ID=123456789-abcdefghijk.apps.googleusercontent.com -- npx -y @mcp-z/mcp-gmail. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is Gmail the official server?

Gmail is a community project by mcp-z, not verified by a company domain.

Is Gmail free?

The code is public, but no licence file was found, so check the repository before commercial use.

Is Gmail safe to use?

It scores 51 of 100. Grades: licence F, quality C. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to Gmail?

Similar MCP servers: OpenWork MCP Gateway, Modelcontextprotocol Core, Agents MCP, MCP Remote.

Does Gmail work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.