# Google Workspace CLI `gws` is a CLI for Google Workspace that dynamically builds its command surface from Google's Discovery Service rather than maintaining a static command list. It covers Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin APIs, and every other Google API available through the Discovery Service. Built for both humans and AI agents, licensed under Apache 2.0. ## Key Features - **Dynamic command surface**: uses two-phase parsing — reads the service name, fetches the Discovery Document (cached 24h), builds a command tree, then executes - **Human-friendly**: built-in `--help` on every resource, `--dry-run` preview, auto-pagination, structured JSON output, no boilerplate - **AI agent support**: 40+ agent skills, 100+ skill files for supported APIs, 50 curated recipes for Gmail, Drive, Docs, Calendar, Sheets - **Auth options**: interactive OAuth, manual OAuth, service accounts, pre-obtained access tokens, environment variables - **Multipart file uploads**, Model Armor integration, [[Gemini CLI]] extension compatibility, headless/CI workflow support ## Installation ```bash npm install -g @googleworkspace/cli ``` Also available via pre-built binaries or Rust/Cargo. ## Usage Examples ```bash gws drive files list --params '{"pageSize": 10}' ``` ## References - https://github.com/googleworkspace/cli ## Related - [[Google CLI (gog)]] - [[Command Line Interface (CLI)]] - [[Gemini CLI]]