Google MCP 工具

这是一系列 Google 原生工具（例如，Gmail、日历），用于 MCP 协议，旨在与 Claude 或 Cursor 等 AI 客户端无缝集成。

<details> <summary>JSON 配置</summary>

{
  "mcpServers": {
    "google-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "google-mcp@latest"],
      "env": {
        // 可以使用其中任何一个，但不能同时使用
        // 使用 OAuth
        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS> CAN_BE_ANYWHERE_ON_YOUR_SYSTEM",
        // 使用服务帐户
        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
      }
    }
  }
}

</details>

功能

• Gmail:
  • 发送带有多个收件人（收件人、抄送、密送）和附件的电子邮件。
  • 使用自定义查询、标签和结果限制列出电子邮件。
  • 通过 ID 读取特定电子邮件。
  • 管理标签（添加、删除、列出）。
  • 草拟和删除电子邮件。
• 日历:
  • 列出日历并设置默认日历。
  • 创建包含详细信息（摘要、开始/结束时间、参与者等）的事件。
  • 列出具有可自定义过滤器的即将发生的事件。
  • 更新或删除现有事件。
  • 查找用于安排日程的空闲时间段。
• Drive:
  • 使用搜索查询进行过滤
  • 按修改日期或其他条件排序
  • 自定义显示计数
  • 查看详细的文件元数据
  • 读取文件内容（文本、文档、电子表格）
  • 创建具有指定内容的新文件
  • 更新现有文件
  • 删除文件（放入回收站或永久删除）
  • 共享具有特定权限的文件
• Tasks:
  • 查看所有任务列表
  • 创建新任务列表
  • 删除现有任务列表
  • 设置默认任务列表
  • 列出带有过滤器的任务
  • 查看任务详细信息
  • 创建具有标题、注释和截止日期的任务
  • 更新任务属性
  • 将任务标记为已完成
  • 删除任务
• TODO 计划:
  • Google Contacts: 搜索和管理联系人。
  • 还有更多...

您可以链接命令以进行工作流程，例如：

“列出我未读的电子邮件，草拟回复最新的一封，并安排明天下午 2 点的后续会议。”

手动安装

1. 前提条件：

   • 安装 Bun：

   brew install oven-sh/bun/bun  # macOS/Linux with Homebrew
   

2. 设置 OAuth：

   • 在 Google Cloud Console 中创建一个 Google Cloud 项目。
   • 设置 OAuth 2.0 凭据（客户端 ID、客户端密钥）。
   • 选择类型为桌面应用。
   • 如果使用测试模式，请将您的电子邮件添加到测试用户列表。
   • 确保为所需服务（Gmail、日历、Drive 等）启用 API 访问。

3. 配置您的客户端：编辑您的 claude_desktop_config.json（或您的客户端的等效配置文件）：

{
  "mcpServers": {
    "google-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "google-mcp@latest"],
      "env": {
        // 可以使用其中任何一个，但不能同时使用
        // 使用 OAuth
        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS>",
        // 使用服务帐户
        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
      }
    }
  }
}

4. 身份验证：
   • 首次运行服务器时，它将打开一个浏览器进行 OAuth 身份验证。 按照提示授予访问权限，令牌将保存到 GOOGLE_OAUTH_TOKEN_PATH。

用法

现在，要求 Claude 使用 google-mcp 工具。

发送一封电子邮件给 jane.doe@example.com，主题为“会议记录”，内容为“这是今天的记录。”

列出未来 3 天内我即将到来的日历事件。

明天上午 10 点创建一个名为“团队同步”的日历事件，持续 1 小时。

本地开发

git clone https://github.com/vakharwalad23/google-mcp.git
cd google-mcp
bun install
bun run index.ts

感谢您使用 Google MCP 工具！ 如果您有任何问题或建议，请随时提出问题或为项目做出贡献。

玩转这些工具，尽情享受吧！！