Google Workspace CLI for Drive, Gmail, Calendar, Docs, Sheets, Chat, Admin reports, and other Workspace API operations.
$npm install -g @googleworkspace/cli
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis
gws is a dynamic Google Workspace CLI that builds commands from Google's Discovery documents and adds helper commands for common Workspace jobs. It covers common services like Drive, Gmail, Calendar, Docs, Sheets, Chat, and Admin reports while still allowing raw API access when you need a less common method.
What It Enables
- List, create, update, and delete resources across Drive, Gmail, Calendar, Docs, Sheets, Chat, Tasks, Meet, Forms, Classroom, Keep, and Admin reports from one shell surface.
- Inspect request and response schemas with
gws schema, then build valid--paramsand--jsonpayloads without manually translating REST docs. - Use higher-level helpers for common jobs like sending Gmail, appending Sheets rows, uploading Drive files, creating calendar events, or chaining cross-service workflows.
Agent Fit
- JSON is the default output, errors are printed as JSON, and
--page-allcan stream paginated results in NDJSON, so follow-up parsing is straightforward. - The generated command tree plus
gws schemagives agents a practical try, inspect, adjust loop even when an API surface changes or a method is unfamiliar. - A large bundled
SKILL.mdtree makes it easier to turn raw Workspace calls into repeatable project-specific workflows.
Caveats
- Initial setup can require a Google Cloud project, OAuth client configuration, API enablement, and browser-based consent before unattended runs are realistic.
- README marks the project as under active development, warns about breaking changes before v1.0, and says it is not an officially supported Google product.