Gmail MCP 配置指南

概述

允许Claude从你的Gmail账户中搜索并检索邮件。

设置步骤

1. 获取 Google API 凭证

1. 访问 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用项目的 Gmail API：
   • 进入 "APIs & Services" > "Library"
   • 搜索 "Gmail API" 并启用它
4. 创建 OAuth 凭证：
   • 前往 "APIs & Services" > "Credentials"
   • 点击 "创建凭证" > "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 可执行文件
• 提供正确的凭证和令牌文件路径

Claude 现在拥有以下工具：

1. 搜索邮件

在你的 Gmail 账户中搜索邮件。

示例提示： "查找所有来自 example@gmail.com 的邮件"

2. 获取邮件内容

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

示例提示： "显示主题为 '明天开会' 的邮件全文"

3. 列出消息

列出你 Gmail 收件箱中的最近邮件。

示例提示： "列出我最 recent 的5封邮件"

环境变量配置

你可以通过环境变量来配置凭证和令牌文件的路径：

• GMAIL_CREDS_PATH：凭证 JSON 文件的路径
• GMAIL_TOKEN_PATH：令牌 JSON 文件的路径

在项目根目录中创建一个 .env 文件，添加这些变量以实现便捷配置。