星标数：32298★ Fork数：1994 《cli：面向人类与 AI 智能体的 Google Workspace 命令行工具》
gws 是一个统一的 Google Workspace 命令行工具，覆盖 Drive、Gmail、Calendar 以及所有 Workspace API，既面向人类用户，也面向 AI 智能体。它消除了样板代码，输出结构化的 JSON，并内置 40+ 个 agent skills。
需要说明的是，本项目不是 Google 官方支持的产品。
gws 并不附带一份静态的命令列表，而是在运行时读取 Google 自己的 Discovery Service，动态构建全部命令面。当 Google Workspace 新增 API 端点或方法时，gws 会自动跟上。项目目前处于活跃开发阶段，在迈向 v1.0 之前可能会出现破坏性变更。
主要特点
- 从 Google Discovery Service 动态构建命令面，自动获取新增的 API 端点与方法
- 所有响应均为结构化 JSON，配合内置的 agent skills，LLM 无需自定义工具即可管理 Workspace
- 面向人类的友好体验：每个资源都有
--help、--dry-run请求预览、自动分页 - 支持多种认证方式：交互式本地登录、手动 OAuth 配置、无头/CI 导出凭证、服务账号、预获取的 Access Token
- 内置 100+ 个 Agent Skills（
SKILL.md），涵盖每个受支持的 API、常用工作流辅助，以及针对 Gmail、Drive、Docs、Calendar、Sheets 的 50 个精选配方 - 可内省任意方法的请求/响应 schema，并以 NDJSON 流式输出分页结果
安装
推荐从 GitHub Releases 页面下载对应操作系统与架构的预编译二进制文件，解压后将 gws 放入 $PATH。也可以使用以下方式安装：
npm install -g @googleworkspace/cli
cargo install --git https://github.com/googleworkspace/cli --locked
nix run github:googleworkspace/cli
brew install googleworkspace-cli快速开始
gws auth setup # 引导完成 Google Cloud 项目配置
gws auth login # 后续的 OAuth 登录
gws drive files list --params '{"pageSize": 5}'更多示例
# 列出最近的 10 个文件
gws drive files list --params '{"pageSize": 10}'
# 创建电子表格
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'
# 发送 Chat 消息
gws chat spaces messages create
--params '{"parent": "spaces/xyz"}'
--json '{"text": "Deploy complete."}'
--dry-run
# 内省任意方法的请求/响应 schema
gws schema drive.files.list
# 以 NDJSON 流式输出分页结果
gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name'📊 本项目 GitHub 星标数：32298。最后更新：2026-10-30，发布：2026-03-31。项目地址：https://github.com/googleworkspace/cli
