Google Gmail 邮件助手

Name: Google Gmail 邮件助手
Author: cablate

cablate

Get started Repository

接入 Gmail，让智能体阅读、搜索、过滤邮件并处理附件

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add google-gmail --env GMAIL_CLIENT_ID='<GMAIL_CLIENT_ID>' --env GMAIL_CLIENT_SECRET='<GMAIL_CLIENT_SECRET>' --env GMAIL_REFRESH_TOKEN='<GMAIL_REFRESH_TOKEN>' -- npx -y @cablate/mcp-gmail

~/.codex/config.toml

[mcp_servers.google-gmail]
command = "npx"
args = ["-y", "@cablate/mcp-gmail"]
env = { GMAIL_CLIENT_ID = "<GMAIL_CLIENT_ID>", GMAIL_CLIENT_SECRET = "<GMAIL_CLIENT_SECRET>", GMAIL_REFRESH_TOKEN = "<GMAIL_REFRESH_TOKEN>" }

# codex mcp add google-gmail --env GMAIL_CLIENT_ID='<GMAIL_CLIENT_ID>' --env GMAIL_CLIENT_SECRET='<GMAIL_CLIENT_SECRET>' --env GMAIL_REFRESH_TOKEN='<GMAIL_REFRESH_TOKEN>' -- npx -y @cablate/mcp-gmail

~/.cursor/mcp.json

{
  "mcpServers": {
    "google-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-gmail"
      ],
      "env": {
        "GMAIL_CLIENT_ID": "<GMAIL_CLIENT_ID>",
        "GMAIL_CLIENT_SECRET": "<GMAIL_CLIENT_SECRET>",
        "GMAIL_REFRESH_TOKEN": "<GMAIL_REFRESH_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "google-gmail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-gmail"
      ],
      "env": {
        "GMAIL_CLIENT_ID": "<GMAIL_CLIENT_ID>",
        "GMAIL_CLIENT_SECRET": "<GMAIL_CLIENT_SECRET>",
        "GMAIL_REFRESH_TOKEN": "<GMAIL_REFRESH_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "google-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-gmail"
      ],
      "env": {
        "GMAIL_CLIENT_ID": "<GMAIL_CLIENT_ID>",
        "GMAIL_CLIENT_SECRET": "<GMAIL_CLIENT_SECRET>",
        "GMAIL_REFRESH_TOKEN": "<GMAIL_REFRESH_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "google-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-gmail"
      ],
      "env": {
        "GMAIL_CLIENT_ID": "<GMAIL_CLIENT_ID>",
        "GMAIL_CLIENT_SECRET": "<GMAIL_CLIENT_SECRET>",
        "GMAIL_REFRESH_TOKEN": "<GMAIL_REFRESH_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "google-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@cablate/mcp-gmail"
      ],
      "env": {
        "GMAIL_CLIENT_ID": "<GMAIL_CLIENT_ID>",
        "GMAIL_CLIENT_SECRET": "<GMAIL_CLIENT_SECRET>",
        "GMAIL_REFRESH_TOKEN": "<GMAIL_REFRESH_TOKEN>"
      }
    }
  }
}

Environment variables

GMAIL_CLIENT_ID
GMAIL_CLIENT_SECRET
GMAIL_REFRESH_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related