Gmail MCP server

Q: How do I add Gmail MCP to Claude Code?

Run `claude mcp add --env 'GOOGLE_CLIENT_SECRET= ' --env 'GOOGLE_REFRESH_TOKEN= ' --env 'GOOGLE_CLIENT_ID= ' mcp-gmail -- npx -y @striderlabs/mcp-gmail` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add Gmail MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

markswendsen-code/mcp-gmail · javascript

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

Also known as markswendsen-code/mcp-gmail, mcp-gmail, @striderlabs/mcp-gmail

stdio

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: —
Latest version: 0.1.0
Last commit: Jun 18, 2026
License: —

What is Gmail MCP?

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

How to install Gmail MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --env 'GOOGLE_CLIENT_SECRET=<YOUR_GOOGLE_CLIENT_SECRET>' --env 'GOOGLE_REFRESH_TOKEN=<YOUR_GOOGLE_REFRESH_TOKEN>' --env 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' mcp-gmail -- npx -y @striderlabs/mcp-gmail

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@striderlabs/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>",
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mcp-gmail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@striderlabs/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>",
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>"
      }
    }
  }
}

$ code --add-mcp '{"name":"mcp-gmail","type":"stdio","command":"npx","args":["-y","@striderlabs/mcp-gmail"],"env":{"GOOGLE_CLIENT_SECRET":"<YOUR_GOOGLE_CLIENT_SECRET>","GOOGLE_REFRESH_TOKEN":"<YOUR_GOOGLE_REFRESH_TOKEN>","GOOGLE_CLIENT_ID":"<GOOGLE_CLIENT_ID>"}}'

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@striderlabs/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>",
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>"
      }
    }
  }
}

$ codex mcp add mcp-gmail --env 'GOOGLE_CLIENT_SECRET=<YOUR_GOOGLE_CLIENT_SECRET>' --env 'GOOGLE_REFRESH_TOKEN=<YOUR_GOOGLE_REFRESH_TOKEN>' --env 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' -- npx -y @striderlabs/mcp-gmail

~/.codex/config.toml

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

[mcp_servers.mcp-gmail.env]
GOOGLE_CLIENT_SECRET = "<YOUR_GOOGLE_CLIENT_SECRET>"
GOOGLE_REFRESH_TOKEN = "<YOUR_GOOGLE_REFRESH_TOKEN>"
GOOGLE_CLIENT_ID = "<GOOGLE_CLIENT_ID>"

$ gemini mcp add -s user -e 'GOOGLE_CLIENT_SECRET=<YOUR_GOOGLE_CLIENT_SECRET>' -e 'GOOGLE_REFRESH_TOKEN=<YOUR_GOOGLE_REFRESH_TOKEN>' -e 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' mcp-gmail npx -- -y @striderlabs/mcp-gmail

~/.gemini/settings.json

{
  "mcpServers": {
    "mcp-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@striderlabs/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>",
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>"
      }
    }
  }
}

Set 3 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

GOOGLE_CLIENT_SECRETRequiredSecret
Google OAuth 2.0 Client Secret
GOOGLE_REFRESH_TOKENRequiredSecret
Google OAuth 2.0 Refresh Token for the user's Gmail account
GOOGLE_CLIENT_IDRequired
Google OAuth 2.0 Client ID from Google Cloud Console

Name	Description
GOOGLE_CLIENT_SECRET	Google OAuth 2.0 Client Secret	RequiredSecret
GOOGLE_REFRESH_TOKEN	Google OAuth 2.0 Refresh Token for the user's Gmail account	RequiredSecret
GOOGLE_CLIENT_ID	Google OAuth 2.0 Client ID from Google Cloud Console	Required

Gmail MCP questions

How do I add Gmail MCP to Claude Code?

Run claude mcp add --env 'GOOGLE_CLIENT_SECRET=<YOUR_GOOGLE_CLIENT_SECRET>' --env 'GOOGLE_REFRESH_TOKEN=<YOUR_GOOGLE_REFRESH_TOKEN>' --env 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' mcp-gmail -- npx -y @striderlabs/mcp-gmail in your terminal. Add --scope user to make it available in every project.

How do I add Gmail MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Facts

Nov 15, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 0.1.0
Last commit: Jun 18, 2026
License: —
Transport: stdio
Package: @striderlabs/mcp-gmail

markswendsen-code ↗

Community publisher

Published by an independent maintainer.

Alternatives

More Gmail MCP servers

Skills for Gmail

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/markswendsen-code/mcp-gmail.svg)](https://hostedmcp.org/servers/markswendsen-code/mcp-gmail/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

$ claude mcp add --env 'GOOGLE_CLIENT_SECRET=<YOUR_GOOGLE_CLIENT_SECRET>' --env 'GOOGLE_REFRESH_TOKEN=<YOUR_GOOGLE_REFRESH_TOKEN>' --env 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' mcp-gmail -- npx -y @striderlabs/mcp-gmail

{ "mcpServers": { "mcp-gmail": { "command": "npx", "args": [ "-y", "@striderlabs/mcp-gmail" ], "env": { "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>", "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>", "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>" } } } }

{ "servers": { "mcp-gmail": { "type": "stdio", "command": "npx", "args": [ "-y", "@striderlabs/mcp-gmail" ], "env": { "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>", "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>", "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>" } } } }

$ code --add-mcp '{"name":"mcp-gmail","type":"stdio","command":"npx","args":["-y","@striderlabs/mcp-gmail"],"env":{"GOOGLE_CLIENT_SECRET":"<YOUR_GOOGLE_CLIENT_SECRET>","GOOGLE_REFRESH_TOKEN":"<YOUR_GOOGLE_REFRESH_TOKEN>","GOOGLE_CLIENT_ID":"<GOOGLE_CLIENT_ID>"}}'

$ codex mcp add mcp-gmail --env 'GOOGLE_CLIENT_SECRET=<YOUR_GOOGLE_CLIENT_SECRET>' --env 'GOOGLE_REFRESH_TOKEN=<YOUR_GOOGLE_REFRESH_TOKEN>' --env 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' -- npx -y @striderlabs/mcp-gmail

[mcp_servers.mcp-gmail] command = "npx" args = ["-y", "@striderlabs/mcp-gmail"] [mcp_servers.mcp-gmail.env] GOOGLE_CLIENT_SECRET = "<YOUR_GOOGLE_CLIENT_SECRET>" GOOGLE_REFRESH_TOKEN = "<YOUR_GOOGLE_REFRESH_TOKEN>" GOOGLE_CLIENT_ID = "<GOOGLE_CLIENT_ID>"

$ gemini mcp add -s user -e 'GOOGLE_CLIENT_SECRET=<YOUR_GOOGLE_CLIENT_SECRET>' -e 'GOOGLE_REFRESH_TOKEN=<YOUR_GOOGLE_REFRESH_TOKEN>' -e 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' mcp-gmail npx -- -y @striderlabs/mcp-gmail

Configuration

GOOGLE_CLIENT_SECRETRequiredSecret

Google OAuth 2.0 Client Secret

GOOGLE_REFRESH_TOKENRequiredSecret

Google OAuth 2.0 Refresh Token for the user's Gmail account

GOOGLE_CLIENT_IDRequired

Google OAuth 2.0 Client ID from Google Cloud Console

Name	Description
GOOGLE_CLIENT_SECRET	Google OAuth 2.0 Client Secret	RequiredSecret
GOOGLE_REFRESH_TOKEN	Google OAuth 2.0 Refresh Token for the user's Gmail account	RequiredSecret
GOOGLE_CLIENT_ID	Google OAuth 2.0 Client ID from Google Cloud Console	Required

Gmail MCP questions

How do I add Gmail MCP to Claude Code?

How do I add Gmail MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Gmail MCP server

What is Gmail MCP?

How to install Gmail MCP

Install Gmail MCP in Claude Code

Install Gmail MCP in Cursor

Install Gmail MCP in VS Code

Install Gmail MCP in VS Code CLI

Install Gmail MCP in Claude Desktop

Install Gmail MCP in Codex

Install Gmail MCP in Codex config.toml

Install Gmail MCP in Gemini CLI

Install Gmail MCP in Gemini settings.json

Configuration

Gmail MCP questions

Gmail MCP server

What is Gmail MCP?

How to install Gmail MCP

Install Gmail MCP in Claude Code

Install Gmail MCP in Cursor

Install Gmail MCP in VS Code

Install Gmail MCP in VS Code CLI

Install Gmail MCP in Claude Desktop

Install Gmail MCP in Codex

Install Gmail MCP in Codex config.toml

Install Gmail MCP in Gemini CLI

Install Gmail MCP in Gemini settings.json

Configuration

Gmail MCP questions