From google-workspace-cli
Watches Gmail inbox for new emails via GCP Pub/Sub push or polling, streams as NDJSON. Use for real-time email monitoring, processing, or data pipelines.
How this skill is triggered — by the user, by Claude, or both
Slash command
/google-workspace-cli:gws-gmail-watchThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Watch for new emails and stream them as NDJSON
gws gmail +watch
| 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 |
gws gmail +watch --project my-gcp-project
gws gmail +watch --project my-project --label-ids INBOX --once
gws gmail +watch --subscription projects/p/subscriptions/my-sub
gws gmail +watch --project my-project --cleanup --output-dir ./emails
npx claudepluginhub pleaseai/claude-code-plugins --plugin google-workspaceWatches Gmail inbox for new emails via GCP Pub/Sub and streams them as NDJSON using gws CLI. Supports label filters, polling, and file output for email processing workflows.
Automates Gmail operations like searching, reading, sending emails, managing drafts/labels via Python CLI scripts with standalone OAuth. Requires Google Workspace.
Reads and searches Gmail for the configured user via the gog CLI, with structured output and Gmail query syntax support.