# Gws

> 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 an older service-specific recipe would have applied.

- Skill: `s3yed/gws` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add s3yed/gws`
- Raw SKILL.md: https://api.skillmd.com/api/skills/s3yed/gws/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: S3YED (https://skillmd.com/u/s3yed)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/s3yed/gws

---


# GWS Workspace Suite

## Overview
Use `gws` when the task lives anywhere in Google Workspace and may cross service boundaries. Keep the shared auth, safety, and formatting rules from `gws-shared` in mind.

## Workflow
1. Read `gws-shared` for auth, global flags, and safety rules.
2. Identify the target service (`gmail`, `calendar`, `drive`, `docs`, `sheets`, `chat`, `tasks`, `meet`, `forms`, `classroom`, `people`, `events`, `modelarmor`).
3. Inspect the exact method with `gws <service> --help` and `gws schema ...` before writes.
4. Prefer the smallest service-specific command that solves the task.
5. For write/delete/share actions, confirm scope before acting.

## References
- `references/common-workflows.md` for cross-service recipe families and service combinations.
- `references/mac-mini-oauth-creds.md` for Google OAuth credential locations on this machine (n8n client, gog built-in, credential file paths).

## Service Map
- **Email:** triage, send, reply, forward, watch.
- **Calendar:** list, create, reschedule, free/busy, recurring events.
- **Drive:** search, upload, download, share, permissions, shared drives.
- **Docs:** read documents, create documents, batch update content.
- **Sheets:** read/update cells, append rows, create reports.
- **Chat / Tasks / Meet / Forms / People / Classroom / Events / Model Armor:** use the service that matches the object you are manipulating; inspect schemas first.

## Common Cross-Service Workflows
- Convert email into tasks or calendar events.
- Announce Drive files in Chat.
- Prepare meeting briefs from calendar + docs + drive links.
- Generate weekly digests from inbox, meetings, and tasks.
- Apply content safety with Model Armor before sending or posting.

## Pitfalls
- Don’t guess field names or payload shapes; inspect the schema.
- Don’t use the wrong service just because it is nearby.
- Don’t skip confirmation for mail, calendar creation, sharing, or deletions.
- Don’t duplicate the shared auth rules; defer to `gws-shared`.