Google Workspace MCP

Google Workspace + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code 技能和 Google Workspace API MCP 服务。与 Google LLC 无关联，也未获得其认可或赞助。

_{▶ 观看 30 秒演示 - 演示数据为模拟数据；展示的每条命令都在真实 CLI 中存在。}

跨客户端 Google Workspace 管理：双重身份验证（2SV）缺口、许可证浪费、共享偏差、安全离职处理。可与您现有的 AI 配合使用——Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot，无需编写代码——还可通过远程方式使用 ChatGPT、Microsoft 365 Copilot / Copilot Studio 和 Google Gemini（在此连接器重新发布前暂停使用；请参阅 mcp-install.md）。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。

适用于您的 Agent

安全说明（在此连接器重新发布之前）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本会检查令牌，但 早于修复版本，尚未设置请求大小和时间限制。MCP 工具 也可以使用您的凭据进行更改。请使用默认的 stdio 传输方式。如果 您为远程 Agent 设置了隧道，请将其关闭。修复版本即将推出。

MSP 所有者最常使用的 Agent（可自行安装，现已可用）：

您的 AI Agent	如何安装 Google Workspace 技能
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 google-workspace-mcp（无需编辑 JSON）。
Codex CLI	粘贴下面的安装提示词。
Claude Code	粘贴下面的安装提示词。
Claude Cowork	粘贴下面的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，将 google-workspace-mcp 添加到 mcp.json 的 servers 键下，然后选择 Agent 模式。

也适用于 ChatGPT 以及 Microsoft 和 Google 产品系列

用户规模庞大，但有一点需要如实说明：这些属于远程 / 企业使用方式，而不是您刚刚安装的本地二进制程序。

Agent	所需条件
ChatGPT（付费方案）	在此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式虽会检查令牌，但尚未设置请求大小或时间限制。请参阅 mcp-install.md 中的安全说明。
Microsoft 365 Copilot / Copilot Studio	在此连接器重新发布前暂停使用：Copilot Studio 需要 HTTP 模式，而此版本的该模式虽会检查令牌，但尚未设置请求大小或时间限制。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 可在本地运行——与 Claude Code 相同。Gemini app 在远程运行，需要使用与 ChatGPT 相同的暂停版 HTTP 模式。请参阅 mcp-install.md。

原生支持技能的 Agent（也已涵盖）： Hermes 和 OpenClaw 可直接读取此技能的 SKILL.md，并且支持 MCP——请参阅下方的安装章节。也可通过 MCP 与 Cursor、Windsurf、Cline、Continue.dev 和 Zed 配合使用。各工具的完整配置方法：docs/which-agent.md。

要使用多个 Agent？ 只需一条命令，即可安装到所有 51+ 个受支持的 Agent：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后为 CLI/MCP 二进制程序运行相应技能的安装程序）。请参阅 docs/which-agent.md。

60 秒完成安装

Claude Desktop 的最快安装方式——一键安装 .mcpb

下载 Google Workspace MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需 shell。客户端租户通过 CLI 注册（tenants add 只能通过 CLI 执行），因此也请安装它（见下方路径 B）。（在发布页面浏览所有 Google Workspace 版本。）

更倾向于使用 Claude Code 插件？只需添加一次 marketplace，然后安装即可立即使用，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install google-workspace@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中：

在此 Agent 工作区中安装 Servosity/msp-skills 提供的 Google Workspace Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/google-workspace/install.sh)。如果使用 Windows PowerShell，运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/google-workspace/install.ps1 | iex。然后按照 README 进行身份验证，并运行 google-workspace-cli --help 了解详情。

任何能够运行 shell 的 Agent 都可以使用同一条提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/google-workspace/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/google-workspace/install.sh)

安装程序会将 google-workspace-cli（CLI）和 google-workspace-mcp（MCP 服务）都放入用户的 bin 路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

google-workspace-cli --version

升级到最新版本

安装程序始终获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/google-workspace/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/google-workspace/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update google-workspace@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的连接方式——每个 Agent 都有对应的章节，其中包括 GitHub Copilot 的 servers 键，以及远程 Microsoft 365 Copilot / Copilot Studio 的配置方式。Claude Desktop 的 Settings > Extensions 面板是最简单的安装方式；面向偏好编辑 JSON 的用户，mcp-install.md 中也提供了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/google-workspace --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/google-workspace --force

Hermes 原生支持 MCP，因此也可以直接使用 google-workspace-mcp 服务——安装方式和环境变量均相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/google-workspace 安装 google-workspace skill。该 skill 说明了如何通过 openclaw: frontmatter 块安装其所需的 CLI（google-workspace-cli）。

OpenClaw 目前尚未全面开放；frontmatter 配置已预先附带，并会在 OpenClaw 发布时立即生效。

身份验证

每个客户端都是一个租户：一个启用了全网域委派的 Google Cloud 服务账号，用于模拟该客户端的超级管理员。请为每个客户端单独设置一个：

1. 在 Google Cloud 项目中启用 Admin SDK API 和 Enterprise License Manager API（如果要使用 policy 配置文件，还需启用 Cloud Identity API；如果是经销商网域，还需启用 Google Workspace Reseller API），创建服务账号并下载其 JSON 密钥。（2024 年 5 月之后创建的 Google Cloud 组织默认会阻止创建密钥；组织管理员必须为该项目允许创建密钥。）

2. 注册客户端。密钥会复制到 CLI 的配置目录，并设置为仅所有者可访问的权限（macOS 和 Linux 上为 0600；Windows 上会继承配置文件夹的权限），因此之后请删除下载的原始文件：

   google-workspace-cli tenants add acme --domain example.com --admin [email protected] --key ./acme-sa.json
   

3. 将打印出的客户端 ID 和范围粘贴到客户端的 管理控制台 > 安全性 > 访问和数据控制 > API 控件 > 全网域委派（google-workspace-cli tenants scopes acme 会再次打印这些内容）。

4. 确认 Google 会针对你委派的每个范围签发令牌：

   google-workspace-cli tenants test acme
   

默认的 read 范围配置文件涵盖所有报告。配置文件可用逗号组合，且只有 full 包含 read：如需执行离职处理写入操作，请使用 --scopes full（它还会授权所有用户写入操作，包括删除用户和授予超级管理员权限）；如需将当前的两步验证（2SV）、云端硬盘共享和 Gmail 转发政策纳入 posture，请使用 --scopes read,policy（或 full,policy）；如需注册自己的经销商网域，请使用 --reseller --scopes reseller（该网域不包含在 --all-tenants 中）。单独使用 --scopes policy 会取代 read，导致报告没有可读取的内容。通过 --tenant <name>（或 GOOGLE_WORKSPACE_TENANT）为每条命令选择客户端，或使用 --all-tenants 扇出到所有客户端。

只管理一个组织？将 GOOGLE_WORKSPACE_TOKEN 设置为包含 Admin SDK 范围的 OAuth 访问令牌，而无需注册租户；之后报告会针对该组织运行。注册租户后将不再使用此令牌：如果注册了多个租户，在未指定 --tenant 的情况下运行命令会被拒绝，而不会对令牌所属的组织执行操作。

google-workspace-cli tenants test --all-tenants 才是真正的凭据检查：它会针对每个已注册客户端的每个范围创建令牌，读取各客户端的客户记录和网域；如果缺少任何委派，命令会以非零状态退出。它无法判断 License Manager 或 Cloud Identity API 是否已启用（首个需要这些 API 的报告会进行检查），并且在未注册任何租户时没有可检查的内容。doctor 会使用所选租户的令牌（--tenant <name>，或唯一已注册的租户）或单组织令牌，探测一个真实的读取端点；如果凭据被拒绝或主机不匹配，会报告为 ERROR，但除非传入 --fail-on error，否则退出状态为 0。

此技能能做什么

MSP 常问的问题	命令
我所有客户中，哪些账号未启用两步验证？按管理员优先排列。	google-workspace-cli mfa-gaps --all-tenants
哪些 Google Workspace 许可证分配给了已停用、从未登录或长期不活跃的账号？	google-workspace-cli stale-licenses --all-tenants
我们已停用的离职员工账号是否仍保留许可证、群组、管理员角色、OAuth 令牌，或未完成的 Drive 转移？	google-workspace-cli leavers --all-tenants
QBR 所需的每位客户一行汇总：两步验证覆盖率、未启用两步验证的管理员、闲置许可证，以及 Drive、Calendar 和应用共享设置的变更	google-workspace-cli posture --all-tenants
本周是谁更改了 Drive 或 Calendar 设置？有多少文件被设为外部共享或公开共享（附示例名称）？	google-workspace-cli sharing-drift --all-tenants --since 7d
哪些第三方应用拥有访问客户数据的完整邮件、完整 Drive 或管理员权限？	google-workspace-cli oauth-apps --all-tenants --min-risk high
本周是否出现可疑登录、账号被劫持，或两步验证被关闭的情况？	google-workspace-cli login-alerts --all-tenants --since 7d
在进行任何更改之前，逐步预览停用这位离职员工账号会产生什么影响。	google-workspace-cli offboard "[email protected]" --successor "[email protected]" --ou "/Departed"
每位客户的全网域委派是否仍处于授权状态？	google-workspace-cli tenants test --all-tenants

完整命令参考：guide.md。AI Agent 操作规范（--agent、--dry-run，以及何时在执行变更前确认）请参阅 AGENTS.md。

有何不同

大多数 Google Workspace MCP 服务（例如 taylorwilsdon/google_workspace_mcp）仅能在一个组织的 Gmail、Drive 和 Docs 中工作。GAM 是大多数 MSP 用于管理 Workspace 的工具，它为每位客户保留一个配置区段，并可将命令循环应用于所有区段，汇总到一个 CSV 中；但针对每个问题，你都得自行编写循环、查询，以及跨用户、许可证、管理员角色和审计日志的联接操作。

此技能维护一个客户租户注册表，每个租户都有自己的服务账号和最小权限范围配置，并行处理每个租户的问题。mfa-gaps、stale-licenses、leavers、posture、sharing-drift、oauth-apps 和 login-alerts 已经能够按客户完成这些联接操作，并返回一张排序表；无法读取的客户会列入 fetch_failures，绝不会被悄悄遗漏。对于更深入的单客户操作，sync 会将一个租户同步到本地 SQLite 镜像（每个租户单独保存），供 search、analytics 和 MCP 服务的 sql 工具使用。

要解决的痛点

在 r/msp 的 "Google Workspace Management" 讨论串（2026 年 6 月）中，发帖者询问有没有“Google Workspace 方面的 CIPP 替代品”。一位管理着约 250 个客户、其中约 10 个使用 Workspace 的 MSP 将其称为“大部分时候都是手动处理”，最常见的回答是使用多租户 GAM：“只要用 GAM select company 就能切换公司。”Microsoft 为 MSP 提供 GDAP 和 CIPP；Google 则为每个客户提供独立的管理控制台。因此，所有客户的业务中，所有者会问到的问题——谁没有启用 2SV、哪些许可证被浪费、哪些离职员工的账户从未彻底清理——都会变成登录、导出和合并电子表格的循环。离职员工会造成实际损失：Google 对已暂停账户的收费与活跃账户相同。

此技能弥补了这一差距：

• google-workspace-cli mfa-gaps --all-tenants - 列出所有客户中未启用 2SV 的账户，未注册的管理员排在最前面。
• google-workspace-cli stale-licenses --all-tenants - 列出已暂停、从未登录或闲置账户上的 Workspace 和付费 Education 版本席位，以便回收（--products 会替换默认值 Google-Apps,101031，因此请一并列出它们：--products Google-Apps,101031,Google-Vault）。
• google-workspace-cli leavers --all-tenants - 列出仍持有许可证、属于某个群组、拥有管理员角色或 OAuth 令牌，或尚未完成云端硬盘转移的已暂停账户。
• google-workspace-cli offboard "[email protected]" --successor "[email protected]" - 执行离职处理流程，先通过实时读取预览操作，再进行任何更改；暂停账户是最后一步，因为清理备用验证码时账户不能处于暂停状态。
• google-workspace-cli posture --all-tenants - 为季度业务回顾（QBR）按客户生成一行汇总。

更完整的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

当前版本不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着需要以 HTTP 模式运行 Google Workspace MCP 服务。当前版本的 HTTP 模式会检查令牌，但尚未设置请求大小或时间限制，因此在重新发布连接器之前，请勿运行该模式或将其置于隧道之后。mcp-install.md 中的安全说明解释了原因。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这能与 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 配合使用吗？

可以——它们都支持 MCP。跨工具安装命令请参阅上方的对照表，以及 docs/which-agent.md 中的详细说明。

我需要懂编程吗？

不需要。推荐的安装方式是将一句话粘贴到 Claude Code 或 Codex 中——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是使用适用于各操作系统的一行安装程序（bash 或 PowerShell）。两种方式都不需要编写代码。每个客户端只需通过 google-workspace-cli tenants add 注册一次（见上文“身份验证”部分）。

我的 Google Workspace 数据安全吗？

你的数据会保留在本机。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在用户账户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而非原始批量数据。每个客户端的服务账号密钥都会复制到 CLI 的配置目录，并设置为仅所有者可访问（macOS 和 Linux 上的模式为 0600；在 Windows 上，文件会继承配置文件夹的权限）；这些密钥仅用于从 Google 获取短期令牌。MSP Skills 不会将密钥打包进此仓库，也不会将其传输到任何地方。

我需要成为 Google 合作伙伴或经销商吗？

不需要。每个客户租户只需使用一个服务账号，并由客户自己的超级管理员授权进行全网域委派。经销商身份仅在使用经销商 API 命令（reseller-customers、subscriptions）时才有用；这些命令针对的是你自己的经销商网域，该网域需使用 --reseller --scopes reseller 注册。

Agent 能修改我客户的 Google Workspace，还是只能读取？

每个客户允许的操作仅限于您授权的范围。默认的 read 范围配置涵盖所有报告，但 Google 没有适用于 OAuth 令牌和应用专用密码的只读范围，也没有适用于许可证分配的只读范围，因此即使使用该配置，仍可撤销令牌、让用户退出登录、读取备份验证码、关闭 2SV 并更改许可证。请确保这些命令始终有人参与审核（参见下方的安全模型）。离职处理写入操作需要 --scopes full，而 offboard 只会预览，除非您亲自输入 --yes；MCP 客户端无法传入该参数。

这会消耗 Google API 配额吗？

跨客户命令会实时查询 Google，因此会计入拥有各客户服务账号的 Google Cloud 项目的 Admin SDK 配额。--concurrency 用于限制并行处理的客户数量，--max-scan-pages 用于限制分页数量；调用失败或达到上限的客户会列在 fetch_failures 中，而不会被悄然丢弃。

它能取代 Google 管理控制台吗？

不能。Google 管理控制台仍是深入处理单个客户事务，以及管理 API 未开放设置的首选位置。此工具为您提供控制台没有的跨客户视图，并让 AI Agent 能用日常语言执行操作。

费用是多少？

免费，采用 Apache-2.0 许可。您只需为使用的 AI Agent（Claude、ChatGPT、Codex 等）付费；费用由您的 AI 提供商收取，而不是由我们收取。

安全模型

层级	示例	建议的 Agent 策略
读取	mfa-gaps、stale-licenses、leavers、posture、sharing-drift、oauth-apps、login-alerts、tenants list、users list、sync、不带 --yes 的 offboard "<email>"（预览）	允许
写入（常规）	users insert/patch、users aliases insert、groups insert/patch、members insert、orgunits insert/patch、users undelete、domains insert、tenants add 和 tenants test（仅限本地配置；密钥解析到其他组织的客户会被隔离，其本地镜像也会被移至一旁）	使用 --dry-run 预览，然后审核写入操作
凭据 / 安全	verification-codes list（返回用户当前的备份验证码）、verification-codes generate/invalidate、two-step-verification（关闭 2SV）、tokens delete、asps delete、users sign-out、users make-admin、带 --password 的 users patch/update、role-assignments insert、roles insert/patch/update/delete	仅限有人参与审核
数据外传	activities watch、users watch、users aliases watch（Google 会将客户的审核事件或用户变更推送到您提供的 --address URL；这些命令可在默认的 read 配置下运行）、resellernotify register，以及任何使用 --deliver webhook:<url> 运行的报告	仅限有人参与审核
破坏性操作 / 计费	offboard --yes、users delete、groups delete、domains delete、transfers insert、license-assignments insert/update/patch/delete、subscriptions insert/change-plan/change-seats/change-renewal-settings/start-paid-service/activate/suspend/delete、reseller-customers insert、mobiledevices action（清除设备）、chromeosdevices action、customer devices-chromeos issue-command/batch-change-status	仅限有人参与审核，并需明确确认

最有力的控制措施是您在每个客户的管理控制台中授权的范围配置——CLI 只能执行该客户的全域委托所允许的操作。完整详情（包括如何收紧权限）请参阅 governance.md。

状态

Beta 版。已根据 Google Workspace API 接口进行验证，目前正在每周 Build Sessions 中与使用生产租户运行该工具的 MSP 一起进行验证。请在 compoundingteams.com/build-sessions RSVP。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。最后更新：2026-10-13。