Google Workspace CLI (gws)

First-time setup

1. Check if gws is installed: gws --help
2. If not, install it: npm install -g @anthropic-ai/gws (or follow the gws project README)
3. Authenticate: gws auth login — this opens a browser for OAuth consent
4. Verify: gws gmail users labels list --params '{"userId": "me"}' — should return labels

Ask the user for their Google account email if needed for calendar operations.

gws --help          # full CLI reference
gws gmail --help    # Gmail commands + helpers
gws calendar --help # Calendar commands + helpers

Key conventions