近 3 万 Star 的开源 CLI 把 Gmail、Drive、Calendar、Sheets 封装成统一接口，内置 100 多个 Agent Skills，人类和 AI 都能用
近 3 万 Star 的开源 CLI 把 Gmail、Drive、Calendar、Sheets 封装成统一接口，内置 100 多个 Agent Skills，人类和 AI 都能用
GPT-5.5加持的Codex单周下载量突破9000万，Token效率提升40%，16人团队月省3.2万美元，开发者正在用脚投票。
Google Workspace 的各个服务 API 一直是割裂的：调邮箱、云盘、日历、表格要分别对接接口、单独配置授权。在 AI Agent 满地跑的 2026 年，让 Agent 操作 Gmail、Calendar、Drive 反而没有顺手工具。Google Workspace CLI 想解决的就是这件事——它把全线产品 API 封装成统一命令行，所有返回数据输出标准 JSON，并内置 100 多个适配 AI 智能体的 Agent Skills。这个项目在 GitHub 拿下近 3 万 Star，但其核心开发者 Justin Poehnelt 却因为该项目被谷歌解雇。本文先讲它做了什么、怎么用，再简述那场争议。
一句话定义：把 Google Workspace API 变成一个既适合人类、也适合 AI Agent 调用的统一接口。
--help，支持 --dry-run 预览请求，自动处理分页
项目地址 github.com/googleworkspace/cli，截至目前 Star 量近 3 万。
Gmail、Drive、Calendar、Sheets、Chat、Admin 全线产品的 API 都被封装成同构的命令行子命令。一条命令完成一类操作，省去反复查文档的麻烦。
CLI 采用 two-phase parsing 策略，兼顾性能和动态性：
argv，识别要调用的服务（例如 drive）clap::Command 命令树所有输出（成功结果、错误信息、下载元数据）都以结构化 JSON 返回，方便程序和 LLM 解析。
这是面向 AI Agent 最关键的能力：
SKILL.md 文件形式提供）
完整 Agent Skills 列表，每个 API 对应一个 SKILL.md，组合后能驱动 LLM 完成跨应用任务。
--help 帮助覆盖每个资源--dry-run 预览将要发出的请求，便于调试# 通过 Homebrew 安装（macOS）
brew install googleworkspace/tap/cli
# 或从 GitHub Releases 下载预编译二进制
# https://github.com/googleworkspace/cli/releases
# 首次运行会引导 OAuth 授权
gws-cli gmail messages list --query "is:unread"把项目里的 SKILL.md 文件挂载到你的 Agent 工具目录，Agent 就能自动调用对应技能。例如让 Codex / Claude Code 帮你"找上周所有带附件的未读邮件并下载到本地"，Agent 会自动选择 gmail.messages.list → gmail.messages.get → gmail.attachments.get 这一串命令链。
| 场景 | 命令组合 |
|---|---|
| 列出未读邮件 | gws-cli gmail messages list --query "is:unread" |
| 上传文件到 Drive | gws-cli drive files upload --path ./report.pdf |
| 查询今日日历 | gws-cli calendar events list --time-min "today" |
| 读取 Sheet 数据 | gws-cli sheets values get --range "A1:D100" |
这个工具本身做对了几乎所有事——上线即冲上 Hacker News 第一，引来谷歌内部总监和高管排着队请教。但故事没按"内部创新被公司放大"的剧本走：
💡 提示：对使用者来说，那场争议不影响工具本身的价值。但需要注意——谷歌已发布官方版同款工具 GWS，未来该开源项目能否持续获得内部资源支持存在不确定性，企业级使用前建议评估两条路线的稳定性。
https://github.com/googleworkspace/cliclap::Command）