SkillsAdd

googleworkspace/cli · Official

gws-gmail-watch

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

All-time #685 Trending #1275 Hot #687 First seen Mar 4, 2026
8-week activity · all time api

Installation

$ npx skills add googleworkspace/cli --skill gws-gmail-watch
View on skills.sh ↗ GitHub repository ↗

Summary

  • Stream new Gmail messages as NDJSON with Pub/Sub-backed polling and optional file output.
  • Monitors incoming emails via Gmail API with configurable label filtering (INBOX, UNREAD, etc.) and message format options (full, metadata, minimal, raw) Supports two setup modes: automatic Pub/Sub topic and subscription creation, or connection to existing resources Configurable polling interval, batch size, and one-time pull mode; graceful shutdown with optional resource cleanup Can write each message to a separate JSON file or stream directly to stdout; watch sessions expire after 7 days and must be renewed

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

gmail-workflows Similar name
claude-office-skills/skills

Automate Gmail with intelligent workflows - attachment management, email organization, auto-arc…

4.3K installs
gmail-skill Similar name
idanbeck/claude-skills

Read, search, send, and draft Gmail emails and Google contacts. Use when the user asks to check…

3.5K installs
gmail Similar name
membranedev/application-skills

Gmail integration. Manage communication data, records, and workflows. Use when the user wants t…

779 installs
gws-gmail Similar name
streakyc/googleworkspacecli

Gmail: Send, read, and manage email.

25 installs
gws-gmail-send Similar name
streakyc/googleworkspacecli

Gmail: Send an email.

25 installs
gws-gmail-reply Similar name
streakyc/googleworkspacecli

Gmail: Reply to a message (handles threading automatically).

25 installs

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Apr 1, 2026

The skill provides instructions for watching and streaming Gmail messages using the gws command-line tool. It operates within the expected scope of a productivity tool for Google Workspace. No security issues were detected.

snyk MEDIUM

Analyzed Apr 1, 2026

[MEDIUM] W011: Third-party content exposure detected (indirect prompt injection risk).

socket Score 0.9000 · 0 alerts

Analyzed Apr 1, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from googleworkspace/cli · top by installs.

npx skills add googleworkspace/cli
gws-gmail 74.7K gws-gmail-send 69.5K gws-drive 68K gws-shared 59.4K gws-calendar 55.1K gws-sheets 52.5K gws-docs 52K gws-sheets-read 45.1K gws-docs-write 44.6K gws-calendar-agenda 44.2K

Browse all from googleworkspace/cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 30.8K
License LICENSE
Default branch main
Open issues 129
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.22.5
Declared agents clawdbot
More metadata
version
0.22.5
openclaw
{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws gmail +watch --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,944 B
  • docs SUMMARY.md 77 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 33,900 installs

SKILL.md

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

gws 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

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

  • [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
  • [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands