gws is a powerful CLI tool for Google Workspace that provides unified access to all Google Workspace APIs through a single command-line interface. Built with Rust and dynamically generated from Google's Discovery Service, it automatically picks up new API endpoints and methods as Google adds them.
Key Features:
- Dynamic Command Generation: Commands are built at runtime from Google's Discovery Service, ensuring compatibility with all current and future Workspace APIs
- Structured JSON Output: All responses are returned as structured JSON, making it ideal for scripting and AI agent integration
- AI Agent Skills: Includes 100+ pre-built agent skills for common workflows across Gmail, Drive, Docs, Calendar, and Sheets
- Multiple Authentication Methods: Supports interactive OAuth, service accounts, pre-obtained tokens, and headless CI workflows
- Advanced Features: Multipart uploads, auto-pagination, dry-run mode, and Model Armor integration for response sanitization
- Helper Commands: Time-aware helpers like
+agenda,+standup-report, and+weekly-digestthat use your Google account timezone
Use Cases:
- Developers: Automate Workspace operations without writing boilerplate API calls
- System Administrators: Manage Google Workspace resources from the command line
- AI Agents: Provide structured access to Workspace APIs through the included skills
- DevOps Teams: Integrate Workspace operations into CI/CD pipelines
- Power Users: Quickly perform common tasks like sending emails, creating documents, or managing calendar events
The tool supports installation via npm, Homebrew, cargo, or direct binary downloads, and includes a Gemini CLI extension for seamless integration with AI workflows.
