Google Workspace (multi-account)

mcp-google-multi

最全面的本地 Google Workspace MCP 服务：Gmail、Drive、Calendar、Sheets、Docs、Slides、Forms、Contacts、Tasks、Chat、Meet、Analytics（GA4）、Search Console、Classroom、Vault、Admin 等等——将每一种可通过 OAuth 访问的 API 方法都作为工具提供，可同时使用多个 Google 账号，并通过 Claude Code 或任何 MCP 客户端调用。

• 🧰 全面覆盖 — 涵盖 29 项服务的 942 个工具，现已包含 Google Analytics（GA4），另有一个应急出口，可处理其他任何需求 → COVERAGE.md
• 🔑 多账号 — 可通过别名管理任意数量的 Google 账号，也可以一次调用同时分发到所有账号
• 🔒 隐私至上 — 使用你自己的 OAuth 应用，令牌静态加密（AES-256-GCM），默认禁止写入，无遥测、无计量——只与 Google 通信
• 🌐 本地或远程 — 可通过 stdio 在本地运行，也可通过 HTTP 可自托管运行，并内置 OAuth 2.1 服务（支持 Claude Code 的 /mcp 登录和 claude.ai 连接器，无需自定义 UI）。提供开箱即用的 Docker Compose，可选自动配置 HTTPS → 远程设置
• ✉️ 为实际工作打造 — 以 Markdown 格式发送和阅读邮件，支持附件和单次调用回复；提供交互式设置向导和 doctor 自检工具，以及按账号配置的范围配置文件 → 功能介绍

快速设置

第一次接触这些内容？本指南面向刚安装 Claude Code、从未创建过 API 密钥的用户。逐步复制粘贴即可；指南会说明你将看到什么。（已经熟悉技术？请看简明版配置参考。）

1. 安装。 获取 Node.js（绿色的“LTS”按钮，版本 22 或更高），然后运行：

   npm install -g mcp-google-multi
   

   Claude Desktop 用户？可以完全跳过 npm：从最新版本下载 mcp-google-multi.mcpb 捆绑包，双击它（或将它拖到 Claude Desktop → Settings → Extensions），然后在提示时填写第 2 步中的值。

2. 创建 Google 密钥（这是唯一需要手动操作的部分，耗时几分钟，因为 Google 没有办法通过脚本完成）。按照Google Cloud 设置中的分步指南操作，或者直接向 Claude Code 提问：*“带我创建一个用于 mcp-google-multi 的 Google OAuth Desktop 客户端。”*完成后，你会得到两个值：客户端 ID和客户端密钥。整个过程免费，而且仅供你自己使用。

3. 将它们写入文件。 在你要运行程序的文件夹中创建一个名为 .env 的文件，并粘贴以下内容，填入你的值：

   GOOGLE_CLIENT_ID=paste-your-client-id
   GOOGLE_CLIENT_SECRET=paste-your-client-secret
   # any short nickname, then your Gmail address:
   GOOGLE_ACCOUNTS=me:[email protected]
   

   无需创建加密密钥：服务会为你生成并保存一个。

4. 登录。 浏览器会打开；选择你的账号并点击 Allow：

   mcp-google-multi auth --account me
   

5. 将其添加到 Claude Code，然后重启 Claude Code：

   claude mcp add mcp-google-multi -s user -- npx -y mcp-google-multi
   

**遇到任何问题？运行 mcp-google-multi doctor。**它会检查每个环节，并针对任何问题打印具体的修复方法（例如尚未登录，或仍需启用某个 Google API）。当检查结果全部显示为绿色后，只需对 Claude 说：“总结一下我未读的邮件。”

*有多个 Google 账号？*将它们一起添加，例如 GOOGLE_ACCOUNTS=me:[email protected],work:[email protected]，然后针对每个昵称各运行一次第 4 步。

*要在服务器上运行，或从 claude.ai 使用？*请看进阶指南：远程 / HTTP 设置。*从 v5 迁移？*请看 v6 迁移指南。

深入了解：配置参考 · 覆盖范围 · 功能介绍 · 远程 / HTTP 设置 · 在保险库中存储密钥 · 本地使用指标 · 迁移到 v6 · 安全策略 · 路线图

Agent 技能

仓库和 npm 包都在 skills/google-workspace/ 中提供了一项 Agent 技能：手写的 SKILL.md 涵盖账号选择、发现步骤、Gmail 增量扫描、精简结果、写入配置文件以及备用方案；此外还有一个 reference/ 文件夹，其中包含按服务生成的参数表。加载该技能后，Agent 就能正确调用此服务的工具，无需猜测参数名称。

要将其安装到 Claude Code，请将 skills/google-workspace 文件夹复制或符号链接到 ~/.claude/skills/（适用于每个项目），或某个项目自己的 .claude/skills/（仅适用于该项目）：

# from a cloned copy of this repo
ln -s "$(pwd)/skills/google-workspace" ~/.claude/skills/google-workspace

# from the installed npm package
ln -s "$(npm root -g)/mcp-google-multi/skills/google-workspace" ~/.claude/skills/google-workspace

维护者、赞助方和许可证

由 Abdelbaki Berkati 构建并维护——berkati.xyz · @bakissation。阅读案例研究 →

开发由 IdeaCrafters 资助（@IdeaCraftersHQ）——这家工作室为此开源项目的存在提供资金支持。

提供企业版（托管、多租户）：请通过 berkati.xyz 联系（网站上有邮箱或 LinkedIn）。

感谢贡献者 @obatried、@trevor-commits 和 @mjreddy。项目由维护者主导（路线图见 Milestones；欢迎提交错误报告，功能 PR 需事先商定——参见 CONTRIBUTING.md）。**反馈将影响路线图：提交 issue，告诉我们错误、痛点或你希望它具备的功能。**安全问题请提交至 SECURITY.md，切勿公开提交 issue。

基于 MIT 许可证授权。