Google Workspace CLI

活跃
GitHub Rust Apache-2.0

简介

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 共享权限

标签

cli agent rust tools api

分类

🔌 MCP 工具

快速开始

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": "部署完成"}'
访问 GitHub 访问官网

相关项目