| name | gws |
| description | Always consult before any Google Workspace operation via the `gws` CLI: sending or reading Gmail and triaging the inbox, Calendar events and agendas, Docs, Drive files and folders, Sheets, Slides, Forms, and adding, listing, or completing Tasks, reminders, and to-dos. Routes to per-service reference files for auth, flags, and command syntax. |
| metadata | {"category":"productivity","requires":{"bins":["gws"]}} |
Google Workspace (gws CLI)
One entry point for Google Workspace through the gws command-line tool. This file is a router: find your task in the table, then read the matching reference file for full command syntax. Each reference is the upstream generated skill, kept current by gws generate-skills.
Read first, once per session
Read references/gws-shared/SKILL.md for authentication (gws auth login), global flags (--format, --dry-run, --sanitize), method flags (--params, --json, --page-all), and shell-quoting rules. Every service below assumes it.
Confirm with the user before any write or delete, and prefer --dry-run to validate first.
CLI shape
gws <service> <resource> [sub-resource] <method> [flags]
Inspect any command before calling it:
gws <service> --help
gws schema <service>.<resource>.<method>
Service routing table
| Task involves | Reference | Shortcut helpers |
|---|
| Calendar: events, scheduling, agendas | gws-calendar | +insert, +agenda |
| Gmail: messages, threads, labels, drafts | gws-gmail | +send, +read, +reply, +reply-all, +forward, +triage, +watch |
| Docs: read and write documents | gws-docs | +write |
| Drive: files, folders, shared drives | gws-drive | +upload |
| Forms: read and edit forms, responses | gws-forms | — |
| Sheets: read and write spreadsheets | gws-sheets | +append, +read |
| Slides: build and edit presentations | gws-slides | — |
| Tasks: task lists, reminders, to-dos | gws-tasks | — |
The reference files cross-link to each other and to gws-shared with relative paths. Those resolve inside references/ because the whole upstream skills/ tree is mounted there.
Notes
references/ is a symlink to the upstream googleworkspace/cli checkout's skills/ directory. Re-run gws generate-skills in that repo to refresh every reference at once.
- The upstream repo ships ~50 service skills; this router covers only the ones in the table above. To add another, point a new row at its
references/gws-<service>/SKILL.md.