Google Workspace Cli

A unified CLI for every Google Workspace API that builds its command surface dynamically from Google's Discovery Service, so new endpoints appear automatically without updates. You get Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and a dozen other services under one `gws` command with structured JSON output. Handles multi-account auth with encrypted credentials, works in CI via service accounts or exported tokens, and includes full schema introspection for any method. The authentication flow can be browser-assisted for agents. It's under active development with breaking changes expected before v1.0, but if you're automating Workspace tasks or building agents that need reliable API access across the entire suite, this beats maintaining separate client libraries for each service.

skills.sh installs: 455
GitHub stars: 296
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add hoodini/ai-agents-skills --skill google-workspace-cli --agent claude-code

Installs into .claude/skills of the current project.

Files

Google Workspace CLI (`gws`)

One CLI for all of Google Workspace — Drive, Gmail, Calendar, Sheets, Docs, Slides, Chat, Tasks, Admin, Meet, Forms, Keep, and every other Workspace API. Built for humans and AI agents. Structured JSON output. 100+ agent skills included.

Note: This is not an officially supported Google product.

Important: This project is under active development. Expect breaking changes as we march toward v1.0.

Repository: https://github.com/googleworkspace/cli

How It Works

gws does NOT ship a static list of commands. It reads Google's own Discovery Service at runtime and builds its entire command surface dynamically. When Google adds a new API endpoint or method, gws picks it up automatically — zero updates needed.