Gws Shared

This is the foundational reference for using Google Workspace CLI commands through Claude. It covers OAuth and service account authentication, global output formatting options (JSON, table, YAML, CSV), and the core command syntax pattern. The security rules are solid, emphasizing dry-run validation and never exposing secrets. The shell tips are genuinely helpful, especially the zsh history expansion gotcha with exclamation marks in spreadsheet ranges. If you're building workflows that interact with Google Workspace APIs, this gives you the authentication patterns and safety guardrails you need before diving into service-specific commands.

skills.sh installs: 68K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill gws-shared --agent claude-code

Installs into .claude/skills of the current project.

Files

gws — Shared Reference

Installation

The gws binary must be on $PATH. See the project README for install options.

Authentication

# Browser-based OAuth (interactive)
gws auth login

# Service Account
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json

Global Flags

Flag	Description
`--format <FORMAT>`	Output format: `json` (default), `table`, `yaml`, `csv`
`--dry-run`	Validate locally without calling the API
`--sanitize <TEMPLATE>`	Screen responses through Model Armor

CLI Syntax

gws <service> <resource> [sub-resource] <method> [flags]

Method Flags

Flag	Description
`--params '{"key": "val"}'`	URL/query parameters
`--json '{"key": "val"}'`	Request body
`-o, --output <PATH>`	Save binary responses to file
`--upload <PATH>`	Upload file content (multipart)
`--page-all`	Auto-paginate (NDJSON output)
`--page-limit <N>`	Max pages when using --page-all (default: 10)
`--page-delay <MS>`	Delay between pages in ms (default: 100)