gmail-mcp

🚀 Gmail MCP 配置指南

本指南旨在帮助你配置 Gmail MCP，允许 Claude 从你的 Gmail 账户中搜索并检索邮件，为你提供更便捷的邮件管理体验。

🚀 快速开始

按照以下步骤完成 Gmail MCP 的配置：

1. 获取 Google API 凭证
2. 授权应用程序
3. 在 Claude 中配置
4. 环境变量配置

✨ 主要特性

• 搜索邮件：在你的 Gmail 账户中搜索邮件。
• 获取邮件内容：检索特定邮件的完整内容。
• 列出消息：列出你 Gmail 收件箱中的最近邮件。

📦 安装指南

获取 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 放置在你的项目目录中

授权应用程序

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

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 可执行文件
• 提供正确的凭证和令牌文件路径

工具使用示例

搜索邮件

在你的 Gmail 账户中搜索邮件。 示例提示："查找所有来自 example@gmail.com 的邮件"

获取邮件内容

检索特定邮件的完整内容。 示例提示："显示主题为 '明天开会' 的邮件全文"

列出消息

列出你 Gmail 收件箱中的最近邮件。 示例提示："列出我最 recent 的 5 封邮件"

🔧 技术细节

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

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

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