pietz/gws
skills/gws/SKILL.md
Access Google Workspace (Gmail + Calendar) via the `gws` CLI. Use when the user asks to read, search, send, reply to, or manage emails, or to view, create, update, or delete calendar events.
tools
Updated Jun 11, 2026
$ install --global
skillsauthnpx skillsauth add pietz/skills gwsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 13, 2026, 2:30 AM9.5s1 file scanned
SKILL.md
- name:
- gws
- description:
- >
Google Workspace CLI (gws)
First-time setup
- Check if
gwsis installed:gws --help - If not, install it:
npm install -g @anthropic-ai/gws(or follow the gws project README) - Authenticate:
gws auth login— this opens a browser for OAuth consent - Verify:
gws gmail users labels list --params '{"userId": "me"}'— should return labels
Ask the user for their Google account email if needed for calendar operations.
gws --help # full CLI reference
gws gmail --help # Gmail commands + helpers
gws calendar --help # Calendar commands + helpers
Key conventions
- Always use
"userId": "me"for Gmail operations. - Search with
qacross all mail, not just INBOX, unless specifically asked for unread/inbox items. - Always ask for confirmation before sending emails or creating/modifying/deleting calendar events.
- Discover calendars with
gws calendar calendarList listbefore assuming calendar IDs.
Gmail
List & search messages
# Recent inbox messages
gws gmail users messages list --params '{"userId": "me", "labelIds": "INBOX", "maxResults": 10}'
# Search all mail (includes archive)
gws gmail users messages list --params '{"userId": "me", "q": "from:alice subject:dinner", "maxResults": 10}'
# Common q operators: from: to: subject: has:attachment after:2026/03/01 before:2026/03/12 is:unread label:INBOX
List only returns id + threadId. Fetch full content with get.
Read a message
# Metadata only (headers: Subject, From, To, Date)
gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID", "format": "metadata"}'
# Full message with body
gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID", "format": "full"}'
The body is in payload.parts[] or payload.body.data (base64url-encoded).
Triage helper
# Quick unread inbox summary (subject, sender, date)
gws gmail +triage
Send email
# Helper (preferred)
gws gmail +send --params '{"userId": "me"}' --json '{
"to": "[email protected]",
"subject": "Hello",
"body": "Message text here"
}'
# Reply (preserves threading)
gws gmail +reply --params '{"userId": "me", "id": "MSG_ID"}' --json '{
"body": "Reply text"
}'
# Reply all
gws gmail +reply-all --params '{"userId": "me", "id": "MSG_ID"}' --json '{
"body": "Reply text"
}'
# Forward
gws gmail +forward --params '{"userId": "me", "id": "MSG_ID"}' --json '{
"to": "[email protected]",
"body": "FYI see below"
}'
Modify labels (archive, mark read/unread, star)
# Archive (remove from inbox)
gws gmail users messages modify --params '{"userId": "me", "id": "MSG_ID"}' --json '{"removeLabelIds": ["INBOX"]}'
# Mark as read
gws gmail users messages modify --params '{"userId": "me", "id": "MSG_ID"}' --json '{"removeLabelIds": ["UNREAD"]}'
# Mark as unread
gws gmail users messages modify --params '{"userId": "me", "id": "MSG_ID"}' --json '{"addLabelIds": ["UNREAD"]}'
# Star
gws gmail users messages modify --params '{"userId": "me", "id": "MSG_ID"}' --json '{"addLabelIds": ["STARRED"]}'
# Trash
gws gmail users messages trash --params '{"userId": "me", "id": "MSG_ID"}'
List labels
gws gmail users labels list --params '{"userId": "me"}'
Calendar
View upcoming events
# Agenda helper (all calendars)
gws calendar +agenda
# List from primary calendar
gws calendar events list --params '{
"calendarId": "primary",
"timeMin": "2026-03-12T00:00:00Z",
"timeMax": "2026-03-19T00:00:00Z",
"singleEvents": true,
"orderBy": "startTime",
"maxResults": 20
}'
Timed events use start.dateTime / end.dateTime. All-day events use start.date / end.date.
Create an event
gws calendar +insert --params '{"calendarId": "primary", "sendUpdates": "all"}' --json '{
"summary": "Team sync",
"location": "Office",
"start": {"dateTime": "2026-03-15T19:00:00", "timeZone": "Europe/Berlin"},
"end": {"dateTime": "2026-03-15T21:00:00", "timeZone": "Europe/Berlin"},
"attendees": [{"email": "[email protected]"}],
"reminders": {"useDefault": true}
}'
Update an event
gws calendar events update --params '{"calendarId": "primary", "eventId": "EVENT_ID", "sendUpdates": "all"}' --json '{
"summary": "Updated title",
"start": {"dateTime": "2026-03-15T20:00:00", "timeZone": "Europe/Berlin"},
"end": {"dateTime": "2026-03-15T22:00:00", "timeZone": "Europe/Berlin"}
}'
Delete an event
gws calendar events delete --params '{"calendarId": "primary", "eventId": "EVENT_ID", "sendUpdates": "all"}'
Check free/busy
gws calendar freebusy query --json '{
"timeMin": "2026-03-15T00:00:00Z",
"timeMax": "2026-03-15T23:59:59Z",
"items": [{"id": "primary"}]
}'
Pagination
For large result sets, use --page-all to auto-paginate (NDJSON, one page per line):
gws gmail users messages list --params '{"userId": "me", "q": "from:amazon"}' --page-all --page-limit 5
Output formats
Default is JSON. Use --format table for human-readable output, --format csv for export.
Related Skills
pietz/ship
development
VerifiedTrustedCommunity
Finish a build session by shipping the work. Ensure tests exist and pass, validate the functionality, spawn a fresh-eyes subagent review when the change is large or risky, then commit and push to main. Use when the user says "ship", "ship it", "wrap this up and push", "test, commit and push", or otherwise wants the session's changes tested, reviewed, committed, and pushed.
SKILL.mdUpdated Jun 13, 2026
pietz/youtube
development
VerifiedTrustedCommunity
Search YouTube and read video transcripts from the command line. Use this whenever the user wants to find YouTube videos or channels, answer a question using knowledge from YouTube videos, get/read/summarize a video's transcript or captions, or find where in a video something is discussed. Also consider this skill for general purpose research, since YouTube is a rich source of information.
SKILL.mdUpdated Jun 11, 2026
pietz/slides
development
VerifiedTrustedCommunity
Create visual documents (presentations, flyers, brochures, posters) by generating HTML/CSS and converting to PDF via headless Chromium. Use this skill when the user wants to create slides, presentations, pitch decks, flyers, brochures, or posters.
SKILL.mdUpdated Jun 11, 2026
pietz/simplify-codebase
development
VerifiedTrustedCommunity
Find and remove incidental architectural complexity in an existing codebase — structure that accreted through many locally-reasonable edits until the whole became more complex than the problem warrants. Preserves what the software does for its callers while simplifying how it's built. NOT for bug fixes, feature work, formatting/style cleanup, or refactors whose change is already obvious.
SKILL.mdUpdated Jun 11, 2026