gws CLI shared patterns for authentication, global flags, and output formatting. Read this before using any other gws-* skill.
The English summary is being prepared. Showing the original description.
Review the instructions the agent will receive before you install.
gws is a unified CLI for all Google Workspace APIs. It reads Google's Discovery Service at runtime, so every Workspace API endpoint is available without custom integration code.
npm install -g @googleworkspace/cli
gws --version
gws auth setup # One-time: creates Cloud project, enables APIs, logs you in (requires gcloud)
gws auth login # Subsequent scope selection and login
Log in with specific services to stay within testing-mode scope limits:
gws auth login -s drive,gmail,calendar,sheets
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/service-account.json
gws drive files list # Works without interactive login
export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)
# On machine with browser
gws auth export --unmasked > credentials.json
# On headless machine
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/credentials.json
gws <service> <resource> [sub-resource] <method> [flags]
| Flag | Description |
|---|---|
--format <FORMAT> | Output format: json (default), table, yaml, csv |
--dry-run | Validate request locally without calling the API |
--sanitize <TEMPLATE> | Screen responses through Model Armor |
| 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) |
# Browse all services
gws --help
# Browse a service's resources
gws drive --help
# Inspect a specific method's schema
gws schema drive.files.list
gws schema gmail.users.messages.send
! expansion in rangesSheet ranges like Sheet1!A1 contain ! which zsh interprets as history expansion. Use double quotes:
# WRONG (zsh mangles the !)
gws sheets +read --spreadsheet ID --range 'Sheet1!A1:D10'
# CORRECT
gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"
gws drive files list --params '{"pageSize": 5}'
--dry-run for any destructive or sending operation--sanitize for PII screening when processing user-generated content# Start a built-in MCP server exposing selected APIs
gws mcp -s drive,gmail,calendar,sheets
This exposes all methods of the selected services as MCP tools, giving any MCP-compatible AI agent direct Workspace access without additional integration code.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
The English summary is being prepared. Showing the original description.
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
The English summary is being prepared. Showing the original description.
Control a headless browser to navigate URLs, click elements, fill forms, extract content from JavaScript-rendered pages, take screenshots, and automate end-to-end web workflows.
The English summary is being prepared. Showing the original description.
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
The English summary is being prepared. Showing the original description.
Review code for quality, simplicity, and maintainability. Identifies unnecessary abstractions, duplicated logic, oversized functions, missing error handling, and naming issues — then fixes them automatically before presenting the result.
The English summary is being prepared. Showing the original description.
WooCommerce store operations through NV oOS Pro — product research, catalog cross-referencing, inventory lookups, and Shopify or Flowhub comparisons where integrations are configured.
The English summary is being prepared. Showing the original description.