GWS Gmail Watch skill: what it does and how to install it
Streams new Gmail messages as NDJSON through the gws CLI, with Pub/Sub setup, label filters, one-off pulls and optional JSON file output.
Summary generated from the skill's documentation.
Install
$ npx skills add googleworkspace/cli --skill gws-gmail-watchRun it in a terminal. If your agent is already running, start a new session so it picks the skill up.
About this skill
What it does. Runs gws gmail +watch to receive new Gmail messages through Pub/Sub and stream them as NDJSON. It can create or use existing topics and subscriptions, filter by labels, choose message format and pull interval, make a single pull, clean up resources, or write each message to a JSON file.
When to use it. Use it to monitor Gmail for incoming messages or feed them into another process. Gmail watches expire after seven days, so the watch must be re-run to renew it.
History
Repo stars
31.2kAbout +423 since 9 Jul 2026
Before 1 Oct 2026 the curve is estimated from public event data.
Stars are counted for the whole repository, which holds 38 skills.
Show as a table
| Date | Repo stars |
|---|---|
| 1 Oct 2026 | 31,223 |
| 24 Sept 2026 (estimated) | 31,201 |
| 17 Sept 2026 (estimated) | 31,167 |
| 10 Sept 2026 (estimated) | 30,961 |
| 3 Sept 2026 (estimated) | 30,844 |
| 27 Aug 2026 (estimated) | 30,833 |
| 20 Aug 2026 (estimated) | 30,828 |
| 13 Aug 2026 (estimated) | 30,828 |
| 6 Aug 2026 (estimated) | 30,811 |
| 30 Jul 2026 (estimated) | 30,805 |
| 23 Jul 2026 (estimated) | 30,805 |
| 16 Jul 2026 (estimated) | 30,805 |
| 9 Jul 2026 (estimated) | 30,800 |
Installs
35.8k
Tracking since . A chart appears once there are 7 days of data.
Installs via skills.sh
Similar skills
- GWS Gmail ReadReads Gmail messages with optional headers, HTML bodies and JSON output through the Google Workspace CLI.
- GWS Gmail ForwardForwards Gmail messages with optional notes, recipients, attachments, HTML formatting, drafts and dry runs through the gws command-line tool.
- Recipe Create Gmail FilterCreates a Gmail filter with the Google Workspace CLI to label, star or categorise incoming messages.