Labsco
googleworkspace logo

gws-gmail-watch

✓ Official★ 29,400

by Google · part of googleworkspace/cli

Gmail: Watch for new emails and stream them as NDJSON.

🔥🔥✓ VerifiedFreeQuick setup
#email#cloud#git#security
🧰 Not standalone. This skill ships with googleworkspace/cli and only works together with that tool — install the tool first, then add this skill.

Gmail: Watch for new emails and stream them as NDJSON.

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by Google

Gmail: Watch for new emails and stream them as NDJSON. npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-watch Download ZIPGitHub29.4k

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

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

Copy & paste — that's it
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

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