AI导哈

Google工具集成服务

Google MCP Tools是一套基于MCP协议的Google原生工具集成服务，支持Gmail、日历、Drive等功能的自动化操作，适用于AI客户端集成和工作流自动化。

  • by FormantIO
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 FormantIO/google-mcp

使用说明

谷歌MCP工具

这是谷歌原生工具（如Gmail、日历）的集合，用于 MCP协议，旨在与Claude或Cursor等AI客户端无缝集成。

JSON configs 
{
  "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：
    • 发送多个收件人（收件人、抄送、密件抄送）和附件的电子邮件。
    • 列出带有自定义查询、标签和结果限制的电子邮件。
    • 按ID阅读特定电子邮件。
    • 管理标签（添加、删除、列出）。
    • 起草和删除电子邮件。
  • 日历：
    • 列出日历并设置默认日历。
    • 创建包含详细信息（摘要、开始/结束时间、与会者等）的活动。
    • 使用可定制的过滤器列出即将发生的事件。
    • 更新或删除现有事件。
    • 寻找空闲时间段进行日程安排。
  • 驱动器：
    • 使用搜索查询进行筛选
    • 按修改日期或其他条件排序
    • 自定义显示计数
    • 查看详细的文件元数据
    • 读取文件内容（文本、文档、电子表格）
    • 使用指定内容创建新文件
    • 更新现有文件
    • 删除文件（垃圾或永久）
    • 共享具有特定权限的文件
  • 任务：
    • 查看所有任务列表
    • 创建新任务列表
    • 删除现有任务列表
    • 设置默认任务列表
    • 使用筛选器列出任务
    • 查看任务详细信息
    • 创建带有标题、注释和截止日期的任务
    • 更新任务属性
    • 将任务标记为已完成
    • 删除任务
  • 所有计划：
    • 谷歌联系人：搜索和管理联系人。
    • 还有更多。..

您可以为工作流链接命令，例如：

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

手动安装

  1. 先决条件：

    • 安装Bun：
    brew install oven-sh/bun/bun  # macOS/Linux with Homebrew

  2. 设置OAuth：

    • 在中创建Google Cloud项目 谷歌云控制台.
    • 设置OAuth 2.0凭据（客户端ID、客户端密码）。
    • 选择桌面应用程序类型。
    • 如果使用测试模式，请将您的电子邮件添加到测试用户列表中。
    • 确保启用API访问所需的服务（Gmail、日历、驱动器等）。

  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。

用法

现在，让克劳德使用 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

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

玩这些工具，享受吧！！

相关 MCP