Gmail-MCP-Server

Gmail-MCP-Server is a local MCP server: Lean Gmail MCP server with auto authentication support. Install it from npm as @artymclabin/gmail-mcp.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add gmail-mcp-server -e GMAIL_OAUTH_PATH=... -e GMAIL_CREDENTIALS_PATH=... -- npx -y @artymclabin/gmail-mcp

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@artymclabin/gmail-mcp"
      ],
      "env": {
        "GMAIL_OAUTH_PATH": "...",
        "GMAIL_CREDENTIALS_PATH": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Node.js 18+ (runs with npx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: GMAIL_OAUTH_PATH, GMAIL_CREDENTIALS_PATH