gws is a Rust-based CLI that dynamically builds a command surface for Google Workspace APIs by querying Google's Discovery Service, with 100+ AI agent skills and multi-service support.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Google Workspace CLI (gws) is a single command-line tool that interfaces with Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. It reads Google’s Discovery Service at runtime to construct its command surface dynamically and includes AI agent skills.
How it works
The CLI does not ship a fixed command list; instead it queries Google Discovery at runtime to build available commands. It provides structured JSON outputs and includes agent skills for automated workflows. It also supports various authentication flows (token, credentials file, service account, etc.) and environment-variable overrides.
Getting started
Prerequisites include Node.js 18+ for npm install (or pre-built binaries), and a Google Cloud project for OAuth credentials. Installation options:
- Download pre-built binary from GitHub Releases and place the gws binary in your PATH.
- Using npm:
npm install -g @googleworkspace/cli
- Build from source:
cargo install --git https://github.com/googleworkspace/cli --locked
- Homebrew (macOS/Linux):
brew install googleworkspace-cli
Quick start examples:
gws auth setup
ngws auth login
ngws drive files list --params '{"pageSize": 5}'
Recent releases
Latest 5 releases (latest first): v0.22.5 (2026-03-31): Installation section indicates downloading the archive for OS/architecture. v0.22.4 (2026-03-31): Noted changes including removal of cargo-dist and using native fetch for npm installer. v0.22.3 (2026-03-26): Release notes include patch changes like Lint Skills CI adjustments and test path fixes. v0.22.1 (2026-03-25): Sync generated skills with latest Google Discovery API specs. v0.22.0 (2026-03-24): Added --draft flag to Gmail helpers for saving drafts.
Traction
30193 stars, 1765 forks, 119 open issues as of the data provided.
Behind the repo
Repository is hosted under googleworkspace/cli with the Gemini CLI Extension integration described:
- Gemini extension installation:
gemini extensions install https://github.com/googleworkspace/cli. - OpenClaw integration example and skills marketplace usage are described in the README.
Caveats
License: Apache-2.0. Created 2026-03-02. Last push 2026-08-01. Language: Rust. Open issues: 119. Network effects not evaluated here beyond raw counts.