Google MCP 工具

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

{
  "mcpServers": {
    "google-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "google-mcp@latest"],
      "env": {
        // Either can be used, but not both
        // Use 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",
        // Use Service Account
        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
      }
    }
  }
}

功能

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

你可以将命令链接起来形成工作流，例如：

"列出我的未读邮件，草拟回复最新的邮件，并安排明天下午 2 点的跟进会议。"

手动安装

1. 先决条件:

   • 安装 Bun:

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

2. 设置 OAuth:

   • 在 Google Cloud 控制台 中创建一个 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": {
        // Either can be used, but not both
        // Use OAuth
        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS>",
        // Use Service Account
        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
      }
    }
  }
}

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

使用

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

Send an email to jane.doe@example.com with the subject "Meeting Notes" and body "Here are the notes from today."

List my upcoming calendar events for the next 3 days.

Create a calendar event titled "Team Sync" tomorrow at 10 AM for 1 hour.

本地开发

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

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

尽情使用这些工具并享受它们吧！！