gws-gmail-watch

Stream new Gmail messages as NDJSON with Pub/Sub-backed polling and optional file output.

googleworkspace ↓ 30k

Claude Code

View source ↗

What it does

Gmail watch expires after 7 days — re-run to renew.
Without --cleanup, Pub/Sub resources persist for reconnection.
Press Ctrl-C to stop gracefully.
gws-shared — Global flags and auth
gws-gmail — All send, read, and manage email commands

Requirements & configuration

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Stream new Gmail messages as NDJSON with Pub/Sub-backed polling and optional file output.

Source

Repository: https://github.com/googleworkspace/cli

gws-gmail-watch FAQ

What does the gws-gmail-watch skill do?

Gmail: Watch for new emails and stream them as NDJSON. Gmail watch expires after 7 days — re-run to renew. Without --cleanup, Pub/Sub resources persist for reconnection.

What does gws-gmail-watch require?

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

How do I install gws-gmail-watch?

Run: npx -y skills add https://github.com/googleworkspace/cli --skill gws-gmail-watch --agent claude-code — the source lives at github.com/googleworkspace/cli.

Maintain gws-gmail-watch?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![gws-gmail-watch on getagentictools](https://getagentictools.com/badge/skills/googleworkspace-cli-gws-gmail-watch.svg)](https://getagentictools.com/skills/googleworkspace-cli-gws-gmail-watch?ref=badge)

npx agentictools info skills/googleworkspace-cli-gws-gmail-watch

The second line is the CLI lookup for this page — handy in READMEs and docs.