SuperAPI AI 工具集

gws

通用与其它

查看项目

更新于 10-16 07:19

技能介绍

用途:gws 是 Google 官方发布的 Google Workspace 命令行工具,基于 Google Discovery Service 动态生成,随 Google 新增接口自动覆盖全部 Workspace API,适合脚本化操作与 AI 智能体集成。

主要能力:覆盖 Drive(文件、文件夹、共享、权限)、Gmail(邮件、标签、草稿、发送)、Calendar(日程、邀请)、Sheets(表格、值、格式)、Docs(文档读写)、Chat(空间、消息)、Admin(用户、群组、组织单位)、Tasks、Meet,以及 Discovery Service 中的其他 API。输出为结构化 JSON,可配合 jq 与脚本使用;支持 --page-all 流式分页、--dry-run 预览请求、gws schema 查看方法 schema。

使用方式:安装命令为 npm install -g @googleworkspace/cli,也可用 cargo install --git https://github.com/googleworkspace/cli --locked 或 nix run github:googleworkspace/cli,验证 gws --version。认证需一次性手动设置:有 gcloud 时运行 gws auth setup 再 gws auth login;无 gcloud 时在 GCP 控制台创建项目、启用 Workspace API、创建桌面应用 OAuth 客户端并设置 GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE 后运行 gws auth login;服务账号/无头场景直接设置同一环境变量指向 service-account.json。凭据使用 AES-256-GCM 与操作系统钥匙串静态加密。调用示例:gws drive files list --params '{"pageSize": 10}'、gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'。

MCP 模式:gws mcp 可作为 MCP 服务器,向 Claude、Cursor、VS Code 等暴露 Workspace 工具;用 -s 限定服务,--tool-mode compact 可把 200-400 个工具压缩为约 26 个元工具以节省上下文,例如 gws mcp -s drive,gmail,calendar --tool-mode compact。

适用场景:邮件工作流自动化、日程与可用性管理、表格数据记录与报表拉取、Drive 文件整理与共享、向 Google Chat 空间发送通知,以及 AI 智能体调用 Workspace。

限制:首次使用前必须完成一次性手动认证,需要 GCP 项目;项目处于 pre-v1.0,可能有破坏性变更,应以 GitHub 最新说明为准;本文未提供价格与计费信息。