Google MCP

by vakharwalad23
Verified

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

您可以链接工作流程的命令,例如:

“列出我未读的电子邮件,起草对最新一封的回复,并安排明天下午 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、日历、云端硬盘等)启用 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 工具!如果您有任何问题或建议,欢迎随时提交问题或为项目做出贡献。

使用这些工具并享受乐趣吧!!

-
security - not tested
-
license - not tested
-
quality - not tested

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

  1. Features
    1. Manual Installation
  2. Usage
    1. Local Development
      ID: opwf6bop3j