Google Workspace CLI (gws)

Prerequisites

1. gws must be on $PATH (npm install -g @googleworkspace/cli)
2. Auth: gws auth login (browser OAuth) or GOOGLE_APPLICATION_CREDENTIALS env var
3. Check auth: NODE_NO_WARNINGS=1 gws auth status

Important

• Always suppress Node warnings: prefix commands with NODE_NO_WARNINGS=1
• Read-only first: always confirm access with a read command before writes
• Confirm before writes: never execute write/delete without user approval
• Use --dry-run for destructive operations
• MCP fallback: If mcp__claude_ai_Gmail__* or mcp__claude_ai_Google_Calendar__* tools are available, prefer those for Gmail/Calendar tasks

Quick Reference