finds.dev

googleworkspace/cli

Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.

View on GitHubHomepage ↗

★ 30,063RustApache-2.0updated Jul 2026

// the take

A Rust CLI that wraps every Google Workspace API by dynamically generating its command surface from Google's Discovery Service at runtime. When Google ships a new endpoint, gws picks it up on next invocation without a release. Aimed at both shell scripters who want something better than raw curl and AI agents that need structured JSON output from Workspace.

The Discovery-driven approach is the right call — the command surface can't fall behind the API, and you get --help and schema introspection for free. Credentials are encrypted at rest with AES-256-GCM and stored in the OS keyring, which is more than most CLI tools bother with. Structured exit codes (0–5) and NDJSON pagination make this actually scriptable in a way that curl one-liners never are. The helper commands (+send, +agenda, +standup-report, etc.) paper over the worst Discovery API awkwardness — sending a Gmail message via the raw Discovery surface would be painful.

Still pre-1.0 with breaking changes expected, so you're on a treadmill of keeping up with a moving API. The OAuth setup story is messier than it should be — you need a GCP project, a Cloud Console visit, and manual test-user enrollment before a single command works; that's a lot of friction for a tool billing itself as zero boilerplate. The 85+ scope 'recommended' preset immediately breaks for unverified apps (Google caps testing-mode apps at ~25 scopes), which will bite anyone who follows the quick start without reading the fine print. The binary is distributed via npm for convenience but is actually a Rust binary fetched from GitHub Releases, which means npm is just a download script wrapper — a layer of indirection that can go wrong in ways that are hard to debug.

We read the README, the directory tree and a key source file in July 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
30,063
Forks
1,754
Language
Rust
License
Apache-2.0
Last commit
28 Jul 2026

// nearby

If cli isn't quite it.

All repos →