Gmail MCP

允许Claude从您的Gmail账户中搜索和检索电子邮件。

配置

1. 获取Google API凭证

1. 访问Google Cloud Console
2. 创建一个新的项目或选择一个现有的项目
3. 启用项目的Gmail API
   • 导航到“APIs & Services” > “库”
   • 搜索“Gmail API”并启用它
4. 创建OAuth凭证：
   • 转到“APIs & Services” > “凭证”
   • 点击“创建凭证” > “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. 获取邮件内容

检索特定邮件的全部内容。

示例提示： "显示主题为'Meeting Tomorrow'的邮件的全部内容"

3. 列出消息

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

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

环境变量

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

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

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