Agent skill · software engineering · aiskillstore
gws-gmail-watch
Gmail: Watch for new emails and stream them as NDJSON.
Why this skill is useful
Adds specific commands and flags for integrating Gmail with Google Cloud Pub/Sub that the AI wouldn't reliably generate on its own.
What it needs
Requires gws installed locally. Requires google-cloud account access. About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
gmail +watch PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it. Watch for new emails and stream them as NDJSON Usage Flags Flag Required Default Description ------ ---------- --------- ------------- --project — — GCP project ID for Pub/Sub resources --subscription — — Existing Pub/Sub subscription name (skip setup) --topic — — Existing Pub/Sub topic with Gmail push permission already granted --label-ids — — Comma-separated Gmail label IDs to filter (e.g., INBOX,UNREAD) --max-messages — 10 Max messages per pull batch --poll-interval — 5 Seconds between pulls --msg-format — full Gmail message format: full, metadata, minimal, raw --once — — Pull once and exit --cleanup — — Delete created Pub/Sub resources on exit --output-dir — — Write each message to a separate JSON file in this directory Examples Tips Gmail watch expires after 7 days — re-run to renew. Without --cleanup, Pub/Sub resources persist for reconnection. Press Ctrl-C to stop gracefully. See Also gws-shared — Global flags and auth gws-gmail — All send, read, and manage email commands
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/gws-gmail-watch