Gws Script
- 19.8k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
gws is a CLI tool that dynamically discovers and exposes every Google Workspace API (Drive, Gmail, Calendar, Admin, Sheets, Docs, and more) with structured JSON output and 40+ bundled agent skills.
About
A unified CLI for Google Workspace that dynamically discovers and surfaces Drive, Gmail, Calendar, and every Workspace API at runtime via Google's Discovery Service. Outputs structured JSON, supports OAuth authentication, and ships 40+ pre-built agent skills. Download pre-built binaries for macOS/Windows/Linux or install via npm for automation and scripting workflows.
- One CLI for all Google Workspace APIs (Drive, Gmail, Calendar, Admin, Sheets, Docs, etc.) with structured JSON output
- Dynamic command discovery from Google's Discovery Service - auto-picks up new endpoints and methods
- 40+ pre-built agent skills included; Node.js binary available for macOS, Windows, Linux
Gws Script by the numbers
- 19,765 all-time installs (skills.sh)
- +858 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #21 of 560 CLI & Terminal skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
gws-script capabilities & compatibility
- Capabilities
- email automation · calendar management · drive access · admin operations · structured output
- Works with
- google drive · gmail
- Platforms
- macOS · Linux · Windows
- IDEs
- vscode · cursor ide
- Runs
- Runs locally
- Pricing
- Free
npx skills add https://github.com/googleworkspace/cli --skill gws-scriptAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 19.8k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
What it does
Automate Google Workspace tasks (email, calendar, docs, drive) from CLI or agentic workflows with structured JSON output and 40+ bundled skills.
Who is it for?
Developers automating Google Workspace tasks in CI/CD, agents, or scripts who need structured output and dynamic API coverage
Skip if: Non-Google automation targets or teams without gws CLI installed and authenticated.
When should I use this skill?
Sending emails, managing calendars, accessing Drive docs, running Admin operations from CLI or agents
What you get
One CLI command surface for all Workspace APIs; new methods auto-discovered from Google's Discovery Service
- Pushed Apps Script project files
- CLI command reference for script resources
- Process list output from remote executions
By the numbers
- 40+ pre-built agent skills included
- Supports Node.js 18+
- Dynamic command discovery from Google Discovery Service
Files
script (v1)
PREREQUISITE: Read../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws script <resource> <method> [flags]Helper Commands
| Command | Description |
|---|---|
| `+push` | Upload local files to an Apps Script project |
API Resources
processes
list— List information about processes made by or on behalf of a user, such as process type and current status.listScriptProcesses— List information about a script's executed processes, such as process type and current status.
projects
create— Creates a new, empty script project with no script files and a base manifest file.get— Gets a script project's metadata.getContent— Gets the content of the script project, including the code source and metadata for each script file.getMetrics— Get metrics data for scripts, such as number of executions and active users.updateContent— Updates the content of the specified script project. This content is stored as the HEAD version, and is used when the script is executed as a trigger, in the script editor, in add-on preview mode, or as a web app or Apps Script API in development mode. This clears all the existing files in the project.deployments— Operations on the 'deployments' resourceversions— Operations on the 'versions' resource
scripts
run—
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws script --help
# Inspect a method's required params, types, and defaults
gws schema script.<resource>.<method>Use gws schema output to build your --params and --json flags.
Related skills
Lark SharedWire Feishu/Lark Open Platform auth, tokens, and shared API helpers into agent-built bots and internal tools.475k
Runcomfy CliLet their coding agent call any RunComfy model from the terminal or scripts without managing separate SDKs.298k31
Skills CliDiscover, install, update, and manage reusable agent capabilities from the open Skillselion ecosystem directly inside their coding agent.270k72TzstCreate, extract, list, and script `.tzst` / `.tar.zst` archives from the terminal with the right compression, streaming, and conflict flags.267k72XdropPull files from an Xdrop share URL, decrypt them locally, and land outputs in a chosen directory with optional JSON for automation.266k72
WizardAuthor interactive bash setup wizards that open URLs, capture secrets, write .env upserts, and set GitHub Actions secrets step by step.83.3k188kHow it compares
Use gws-script when you standardize on the gws CLI ecosystem across Google Workspace services.
FAQ
Does gws cover all Google Workspace APIs?
Yes - gws reads Google's Discovery Service at runtime, so it covers every endpoint and method automatically. When Google adds a new API, gws picks it up.
Can I use gws in Node.js scripts or only the CLI?
Both - the npm package exports CLI commands, and you can shell out to gws from Node scripts or import the underlying logic if available.
Is Gws Script safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.