googleworkspace/cli

What it solves

gws is a command-line interface (CLI) that provides a unified way to interact with all Google Workspace APIs (including Drive, Gmail, Calendar, and Sheets). It eliminates the need to write complex curl calls or boilerplate code when managing Workspace resources, providing a structured, developer-friendly way to access these services.

How it works

Instead of shipping with a static list of commands, gws dynamically builds its command surface at runtime by reading Google's Discovery Service. This ensures that whenever Google adds a new API endpoint or method, the CLI automatically picks it up without requiring an update. It uses a two-phase parsing strategy to identify the service and then build a command tree based on the cached Discovery Document.

Who it’s for

• Developers and Power Users: Those who want to manage Google Workspace via the terminal with features like auto-pagination, --dry-run previews, and built-in help.
• AI Agents: Because all responses are structured JSON, it is designed to be used as a tool for LLMs to manage Workspace tasks without needing custom integration code.

Highlights

• Dynamic API Surface: Automatically updates its commands based on Google's Discovery Service.
• AI-Ready: Includes over 100 "Agent Skills" (curated recipes and helpers) to help LLMs perform common workflows.
• Structured Output: All success and error responses are returned as JSON for easy parsing.
• Comprehensive Auth: Supports multiple authentication workflows, including interactive login, service accounts, and pre-obtained access tokens.
• Helper Commands: Provides specialized, human-friendly shortcuts (prefixed with +) for common tasks like sending emails or creating calendar events.
• Security Integration: Integrates with Google Cloud Model Armor to sanitize API responses for prompt injection before they reach an agent.