🚀 Gmail MCP 配置指南

本指南旨在帮助你配置 Gmail MCP，使 Claude 能够从你的 Gmail 账户中搜索并检索邮件，为信息获取提供便利。

🚀 快速开始

✨ 主要特性

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

高级用法

Claude 现在拥有以下工具：

• 搜索邮件：在你的 Gmail 账户中搜索邮件。 示例提示："查找所有来自 example@gmail.com 的邮件"
• 获取邮件内容：检索特定邮件的完整内容。 示例提示："显示主题为 '明天开会' 的邮件全文"
• 列出消息：列出你 Gmail 收件箱中的最近邮件。 示例提示："列出我最 recent 的 5 封邮件"

📚 详细文档

环境变量配置

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

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

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