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 点的后续会议。”
手动安装
- 先决条件:
brew install oven-sh/bun/bun # macOS/Linux with Homebrew
- 设置 OAuth:
- 在Google Cloud Console中创建一个 Google Cloud 项目。
- 设置 OAuth 2.0 凭证(客户端 ID、客户端密钥)。
- 选择桌面应用程序类型。
- 如果使用测试模式,请将您的电子邮件添加到测试用户列表。
- 确保为所需服务(Gmail、日历、云端硬盘等)启用 API 访问。
- 配置您的客户端:编辑您的 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>"
}
}
}
}
- 认证:
- 首次运行服务器时,它会打开浏览器进行 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 工具!如果您有任何问题或建议,欢迎随时提交问题或为项目做出贡献。
使用这些工具并享受乐趣吧!!