Google Workspace CLI
活跃简介
Google Workspace 命令行工具，统一管理 Drive、Gmail、Calendar、Sheets、Docs 等服务，内置 AI Agent 技能。
核心特性
- 动态命令发现 — 运行时读取 Google Discovery Service 自动构建所有 API 命令，Google 新增端点自动支持
- 40+ Agent Skills — 内置 AI Agent 技能，LLM 可直接通过结构化 JSON 输出管理 Workspace
- 多认证方式 — 支持交互式 OAuth、Service Account、预获取 Access Token、CI/Headless 导出凭证等多种认证
- 统一 CLI 入口 — 一个命令行工具管理 Drive、Gmail、Calendar、Sheets、Docs、Chat 等所有 Workspace 服务
- Schema 自省 — 通过 gws schema 命令查看任意 API 方法的请求/响应 Schema
- 自动分页 — 支持 --page-all 参数流式获取分页结果为 NDJSON 格式
适用场景
💡 自动化办公工作流 — 通过 CLI 脚本批量管理 Drive 文件、发送 Gmail、更新 Sheets
💡 AI Agent Workspace 集成 — 让 LLM Agent 通过 gws 命令行操作 Google Workspace 各服务
💡 CI/CD 流水线集成 — 在 GitHub Actions 等 CI 环境中使用 Service Account 自动化 Workspace 操作
💡 数据导出与分析 — 从 Sheets/Docs 提取数据导出为 JSON/NDJSON 用于进一步分析
💡 团队协作自动化 — 自动创建 Calendar 事件、发送 Chat 消息、管理 Drive 共享权限
优势与不足
✅ 优势
- • 活跃维护，近期持续更新
- • 社区热度高（30.8k stars）
- • 开源许可证友好（Apache-2.0）
- • Issue 响应及时，积压少
分类
快速开始
npm install -g @googleworkspace/cli
# 首次设置认证
gws auth setup
gws auth login
# 列出 Drive 文件
gws drive files list --params '{"pageSize": 5}'
# 创建 Sheets
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 预算"}}'
# 发送 Chat 消息
gws chat spaces messages create \
--params '{"parent": "spaces/xyz"}' \
--json '{"text": "部署完成"}'