google-workspace-cli

One CLI for all of Google Workspace — built for humans and AI agents.

gws dynamically generates its command surface at runtime by reading Google's Discovery Service. Drive, Gmail, Calendar, and every Workspace API — zero boilerplate, structured JSON output, 40+ agent skills included.

Install

npm install -g @googleworkspace/cli    # npm
cargo install google-workspace-cli     # crates.io
nix run github:googleworkspace/cli     # nix

Pre-built binaries are available on the GitHub Releases page.

Quick Start

gws auth login
gws drive files list --params '{"pageSize": 5}'
gws gmail users.messages list --params '{"maxResults": 3}'

Documentation

See the full README for authentication setup, helper commands, agent skills, and more.

License

Apache-2.0 — see LICENSE.