AI导哈

Gmail邮件搜索工具

允许Claude搜索和检索Gmail账户中的邮件的工具，适用于需要快速查找和管理电子邮件的场景。

  • by vinayak-mehta
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 vinayak-mehta/gmail-mcp

使用说明

Gmail MCP

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

设置

1.获取Google API证书

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

2.授权申请

运行authorization命令以生成令牌：

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

这将打开一个浏览器窗口，您需要登录您的谷歌帐户并授予必要的权限。授权后，a 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 项目根目录中的文件包含这些变量，便于配置。

相关 MCP