Google Workspace CLI
Description
One CLI for all of Google Workspace — built for humans and AI agents. gws provides unified command-line access to Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin APIs, and more through structured JSON output with zero boilerplate.
Built on Google’s Discovery Service, commands are dynamically generated at runtime so the CLI automatically updates when APIs change. Includes 40+ curated helper commands (prefixed with +) for common workflows like sending email, checking your agenda, uploading files, and generating standup reports.
All responses return valid JSON, making it ideal for scripting, automation pipelines, and AI agent integration. Ships with 100+ agent skills for LLM frameworks, encrypted credential storage (AES-256-GCM), and built-in Model Armor for prompt injection detection.
Quick Install
npm install -g @googleworkspace/cli
Key Features
- → Access Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin APIs from terminal
- → Dynamic command generation from Google Discovery Service
- → 40+ helper commands: +send, +agenda, +upload, +standup-report
- → Structured JSON output for scripting and automation
- → Multiple auth flows: OAuth, service accounts, tokens
- → AES-256-GCM encrypted credential storage
- → Auto-pagination with --page-all flag
- → Dry-run mode to preview API requests
- → 100+ AI agent skills for LLM integration
- → Model Armor prompt injection detection
Installation
npm install -g @googleworkspace/cli
# Or via Homebrew:
brew install googleworkspace-cli
# Or from source (Rust):
cargo install --git https://github.com/googleworkspace/cli --locked