PaperclipOrg
Claude Agent Skill · by Googleworkspace

Gws Gmail Watch

Streams incoming Gmail messages as NDJSON using Google Cloud Pub/Sub, which is useful for building email automation workflows or monitoring specific inboxes. Se

Install
Terminal · npx
$npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-watch
Works with Paperclip

How Gws Gmail Watch fits into a Paperclip company.

Gws Gmail Watch drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.

S
SaaS FactoryPaired

Pre-configured AI company — 18 agents, 18 skills, one-time purchase.

$27$59
Explore pack
Source file
SKILL.md59 lines
Expand
---name: gws-gmail-watchdescription: "Gmail: Watch for new emails and stream them as NDJSON."metadata:  version: 0.22.5  openclaw:    category: "productivity"    requires:      bins:        - gws    cliHelp: "gws gmail +watch --help"--- # 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 ```bashgws gmail +watch``` ## 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 ```bashgws gmail +watch --project my-gcp-projectgws gmail +watch --project my-project --label-ids INBOX --oncegws gmail +watch --subscription projects/p/subscriptions/my-subgws 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 - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands