用途：gws 是面向 Google Workspace 的统一命令行工具，覆盖 Drive、Gmail、Calendar、Sheets、Docs、Chat、Admin 以及通过 Google Discovery Service 发布的其他 API，适合人工操作与 AI 智能体调用。上游为 googleworkspace/cli（Apache 2.0），当前处于 Pre-v1.0，可能出现破坏性变更，生产脚本应固定版本。
主要能力：命令按 gws <service> <resource> <method> [--params '<json>'] [flags] 结构动态生成，Google 新增端点会被自动识别（发现文档缓存 24 小时）。支持 Drive 文件列表/上传/建文件夹/移动，Gmail 收发与读取，Sheets 读写与追加，Docs 创建与获取，Calendar 事件列表与创建，Chat 空间与消息，Admin 目录用户查询等。所有命令返回结构化 JSON，可用 jq 解析。
使用方式：安装 npm install -g @googleworkspace/cli，用 gws --version 验证。认证可执行 gws auth setup、gws auth login、gws auth status；无头环境可用服务账号文件或预取令牌环境变量。凭据以 AES-256-GCM 加密存入系统钥匙串，令牌自动刷新。内置 MCP 服务器通过 gws mcp -s drive,sheets,docs 启动，支持 full 与 compact 两种工具模式，可配置到 Claude Code 或 Claude Desktop。
适用场景：Drive、Sheets、Docs、Chat、Admin 等无原生集成的服务，跨服务批量自动化，以及自定义或新发布的 Google API。
限制：Pre-v1.0 可能破坏兼容；未验证 OAuth 应用约限 25 个 scope；非 Google 官方产品，无企业 SLA；发现文档缓存导致新 API 可能延迟一天出现；上游仓库暂时关闭外部贡献者的 PR。安全上应遵循最小权限，勿泄露令牌，处理不可信输入时可用 --sanitize。