Skip to content
Skills Library
Personal productivity · Tool integration

gws-cli-reference

/gws-cli-reference

Use when working with the Google Workspace `gws` CLI across Gmail, Calendar, Drive, Docs, Sheets, Chat, Tasks, Meet, Forms, Classroom, Events, Model Armor, People, and cross-service workflows. This is the class-level umbrella for command discovery, auth, helper-command selection, and safe execution patterns.

Author
S3YED ↗
Repository
appie-kit ↗
Licence
MIT
Last repository change
26.08.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when working with the Google Workspace `gws` CLI across Gmail, Calendar, Drive, Docs, Sheets, Chat, Tasks, Meet, Forms, Classroom, Events, Model Armor, People, and cross-service workflows. This is the class-level umbrella for command discovery, auth, helper-command selection, and safe execution patterns.

Original author description

Use when working with the Google Workspace `gws` CLI across Gmail, Calendar, Drive, Docs, Sheets, Chat, Tasks, Meet, Forms, Classroom, Events, Model Armor, People, and cross-service workflows. This is the class-level umbrella for command discovery, auth, helper-command selection, and safe execution patterns.

How it works

  1. Core workflow
  2. Shared command pattern
  3. Service map
  4. Helper-command selection
  5. When to branch into references
  6. Safety rules
  7. Verification checklist
Original SKILL.md headings · 74 lines, 425 words
SKILL.md preview
---
name: gws-cli-reference
description: Use when working with the Google Workspace `gws` CLI across Gmail, Calendar, Drive, Docs, Sheets, Chat, Tasks, Meet, Forms, Classroom, Events, Model Armor, People, and cross-service workflows. This is the class-level umbrella for command discovery, auth, helper-command selection, and safe execution patterns.
---

# GWS CLI Reference

Class-level reference for the generated Google Workspace CLI skill family. Prefer this umbrella instead of narrow per-service helpers.

## Core workflow
1. Authenticate once with `gws auth login` or service-account env vars.
2. Start from `gws <service> --help` to see resources.
3. Inspect a concrete method with `gws schema <service>.<resource>.<method>` before building flags.
4. Prefer `--dry-run` for writes and any bulk operation.
5. Use `--format table` for quick scans, `json` for piping, `csv` for exports.

## Shared command pattern
```bash
gws <service> <resource> [sub-resource] <method> [flags]
```

Common flags:
- `--params '{...}'` for query/path params
- `--json '{...}'` for request bodies
- `--upload <path>` for file content
- `--output <path>` for downloads/exports
- `--page-all` for paginated listings
- `--sanitize <template>` when Model Armor screening is relevant

## Service map
### Communication
- Gmail: message/thread/draft/label/history operations, triage, reply, forward, send, watch.
- Chat: spaces, messages, announcements.
- Meet: conference management.

### Scheduling
- Calendar: calendars, ACLs, freebusy, events, agenda views, quick event insertion.

### Files and docs
- Drive: files, permissions, comments, shared drives, uploads, change watches.
- Docs / Sheets / Slides / Forms: content read/write and file-specific operations.

### People and org data
- People, Classroom, Admin Reports, Tasks, Keep.

### Safety and eventing
- Events / events subscriptions / renewals.
- Model Armor template creation plus prompt/response sanitization.

### Workflow helpers
- Meeting prep, standup reports, weekly digests, email-to-task, file announcements.

## Helper-command selection
Use the short helper form when it clearly matches the job:
- Calendar helpers: `+agenda`, `+insert`
- If `gws` is unavailable but `gog` is available, use `references/gog-calendar-oauth-recovery.md` for Calendar OAuth recovery and agenda listing via `gog calendar events`.
- Gmail helpers: `+send`, `+triage`, `+reply`, `+reply-all`, `+forward`, `+watch`
- Gmail helpers: `+send`, `+triage`, `+reply`, `+reply-all`, `+forward`, `+watch`
- Drive helper: `+upload`
- Workflow helpers: `+meeting-prep`, `+standup-report`, `+weekly-digest`, `+email-to-task`, `+file-announce`
- Events helpers: renew or subscribe when maintaining watches
- Model Armor helpers: create-template, sanitize-prompt, sanitize-response

## When to branch into references
Read `references/services-index.md` when choosing a service or helper. Read `references/absorbed-skills.md` when you need the exact old micro-skill names that were absorbed here.

## Safety rules
- Confirm scope before destructive writes/deletes/shares.
- Use `--dry-run` before multi-item changes.
- For permissions/sharing, verify target IDs and recipient emails first.
- For watches/subscriptions, record renewal requirements.

## Verification checklist
- [ ] Chosen the right service for the user task
- [ ] Inspected schema before constructing the call
- [ ] Used dry-run or read-before-write when possible
- [ ] Captured resulting IDs/URLs/status from the command output
Files in this package (3)
  • SKILL.md 3 KB
  • references/absorbed-skills.md 1 KB
  • references/services-index.md 1 KB

Versions

The database has no other skills named gws-cli-reference.

Database snapshot: 13.11.2026 · package version e746b6c140c0 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90gws
    Google Workspace via the gws CLI across Gmail, Calendar, Drive, Docs, Sheets, Chat, Tasks, Meet, Forms, Classroom, People, Events, Model Armor, and cross-service workflows. Use when a task spans multiple gws services, when you need to choose the right Workspace service, or when…
  • 90gws
    Google Workspace CLI. Use when the user mentions Gmail, Google Drive, Calendar, Sheets, Docs, Tasks, People, Slides, Forms, Meet, Classroom, sending email, checking inbox, managing files, reading/writing spreadsheets, viewing schedules, standup reports, or any Google Workspace…
  • 100gws-cli
    Google Workspace CLI (gws) for managing all 18 Workspace APIs from the terminal. Use when running gws commands, listing Drive files, sending Gmail, reading Sheets, creating Calendar events, managing Tasks, querying Chat, pushing Apps Script, building cross-service automations,…
  • 100gws
    Google Workspace CLI (gws) — unified command-line tool for Gmail, Drive, Sheets, Docs, Calendar, Chat, Admin, and 40+ Google APIs. Use this skill when the user wants to interact with any Google Workspace service from the terminal or via AI agents, set up gws authentication,…
  • 100gws
    Google Workspace CLI (gws) — unified command-line tool for Gmail, Drive, Sheets, Docs, Calendar, Chat, Admin, and 40+ Google APIs. Use this skill when the user wants to interact with any Google Workspace service from the terminal or via AI agents, set up gws authentication,…
  • 100gws
    This skill should be used when interacting with Google Workspace services via the gws CLI — Gmail (search, triage, send, labels, filters, drafts), Calendar (agenda, events, Meet conferencing), Drive (upload, list, share, download), Sheets (read, append), Docs, Tasks, Chat…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.