gws-shared
Master Google Workspace CLI Commands
This skill provides comprehensive reference documentation for the gws CLI tool. It helps you authenticate, use global flags, and follow proper CLI syntax for Google Workspace operations.
Download the skill ZIP
Upload in Claude
Go to Settings → Capabilities → Skills → Upload skill
Toggle on and start using
Test it
Using "gws-shared". How do I authenticate with gws?
Expected outcome:
You can authenticate with gws using two methods: 1) Browser-based OAuth with 'gws auth login' for interactive sessions, or 2) Service account by setting the GOOGLE_APPLICATION_CREDENTIALS environment variable to point to your key.json file.
Using "gws-shared". Show me the global flags available in gws
Expected outcome:
gws supports these global flags: --format (output as json/table/yaml/csv), --dry-run (validate without API calls), and --sanitize (screen responses through Model Armor for content safety).
Using "gws-shared". How do I handle shell special characters in gws commands?
Expected outcome:
For zsh, use double quotes when ranges contain '!' (e.g., --range "Sheet1!A1:D10"). For JSON parameters, wrap in single quotes to preserve inner double quotes (e.g., --params '{"pageSize": 5}').
Security Audit
SafeAll static analysis findings are false positives from markdown documentation code blocks. The skill contains only reference documentation for the gws CLI tool with no executable code or actual security risks.
Quality Score
What You Can Build
CLI Quick Reference
Look up gws CLI syntax, flags, and authentication methods while working with Google Workspace APIs from the command line.
Authentication Setup Guide
Learn how to authenticate with gws using browser-based OAuth or service account credentials for automated workflows.
Best Practices Reference
Access security rules and shell tips to ensure safe and proper usage of the gws CLI tool in production environments.
Try These Prompts
How do I authenticate with the gws CLI using a service account?
Show me the gws CLI syntax for listing Google Drive files with JSON output format
How do I use gws to fetch all Gmail messages with automatic pagination and save as CSV?
What is the recommended way to test a destructive gws command before executing it?
Best Practices
- Always use the --dry-run flag first to validate destructive operations before executing them
- Prefer --format json for programmatic processing and --format table for human-readable output
- Use --sanitize flag when handling PII or content that requires safety screening
Avoid
- Do not output secrets or API keys directly in command output - use secure credential management
- Avoid using single quotes for sheet ranges in zsh as the '!' character triggers history expansion
- Never run write or delete commands without confirmation unless in automated scripts with proper safeguards