gws

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                       # browse resources and methods
gws schema <service>.<resource>.<method>   # required params, types, defaults

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.