Files
Simon a3768d0e82 feat(sheets): add --range flag to +append for targeting specific tabs (#641)
Previously +append always used hardcoded "A1" range, limiting appends
to the first sheet. Add optional --range flag (default: "A1") to allow
appending to any sheet tab using A1 notation.
2026-03-31 12:51:15 -06:00
..
2026-03-31 12:32:18 -06:00

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

Download the pre-built binary for your OS and architecture from the GitHub Releases page.

Alternatively, you can use package managers as a convenience layer:

npm install -g @googleworkspace/cli    # npm (downloads GitHub release binary)
cargo install google-workspace-cli     # crates.io
nix run github:googleworkspace/cli     # nix

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.