Gmail MCP

允许 Claude 搜索并检索您 Gmail 帐户中的电子邮件。

设置

1. 获取 Google API 凭据

1. 访问 Google Cloud Console
2. 创建一个新项目或选择一个现有项目
3. 为您的项目启用 Gmail API
   • 导航至“API 和服务”>“库”
   • 搜索“Gmail API”并启用它
4. 创建 OAuth 凭据：
   • 转到“API 和服务”>“凭据”
   • 点击“创建凭据”>“OAuth 客户端 ID”
   • 选择“桌面应用程序”作为应用程序类型
   • 命名您的客户端并点击“创建”
5. 下载凭据 JSON 文件
6. 将其另存为项目目录中的 credentials.json

2. 授权应用程序

运行授权命令以生成您的令牌：

uv run gmail-mcp auth --creds-path credentials.json --token-path token.json

这将打开一个浏览器窗口，您需要在其中登录您的 Google 帐户并授予必要的权限。 授权后，将在您的项目目录中创建一个 token.json 文件。

使用 Claude 进行配置

将 Gmail MCP 服务器添加到您的 Claude 配置文件：

{
  "mcpServers": {
    "gmail": {
      "args": [
        "--from",
        "git+https://github.com/vinayak-mehta/gmail-mcp",
        "gmail-mcp"
      ],
      "command": "/Users/username/.local/bin/uvx",
      "env": {
        "GMAIL_CREDS_PATH": "/Users/username/path/to/gmail-mcp/credentials.json",
        "GMAIL_TOKEN_PATH": "/Users/username/path/to/gmail-mcp/token.json"
      }
    }
  }
}

请务必：

• 将 /Users/username/path/to/gmail-mcp 替换为您的实际项目路径
• 将 command 路径调整为您安装的 uvx 可执行文件
• 提供指向您的 credentials.json 和 token.json 文件的正确路径

Claude 现在将有权访问以下工具：

1. 搜索电子邮件

在您的 Gmail 帐户中搜索电子邮件。

示例提示： “搜索来自 example@gmail.com 的所有电子邮件”

2. 获取电子邮件内容

检索特定电子邮件的完整内容。

示例提示： “显示主题为“明日会议”的电子邮件的完整内容”

3. 列出消息

列出 Gmail 收件箱中的最新消息。

示例提示： “列出我最近的 5 封电子邮件”

环境变量

您可以使用环境变量配置凭据和令牌文件的路径：

• GMAIL_CREDS_PATH：指向您的 credentials.json 文件的路径
• GMAIL_TOKEN_PATH：指向您的 token.json 文件的路径

在项目根目录中创建一个 .env 文件，其中包含这些变量，以便于配置。