googleworkspace/cli

gws-gmail-watch

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

37K installs 32K stars

Before you install

Last update
Files in folder
1
Scripts
No script files found
SKILL.md size
1.9 KB (about 486 tokens of context each time it loads)
License
Apache-2.0
Source on GitHub
googleworkspace/cli

Skills are plain text instructions the agent follows, sometimes with scripts. Check the source, prefer repositories with many installs and stars, and read any script it ships.

Install

npx skills add googleworkspace/cli@gws-gmail-watch

Runs in a terminal with Node.js 18 or newer. Add -y to skip the prompts and -g to install for every project instead of this one.

Install for your agent

npx skills add googleworkspace/cli@gws-gmail-watch --agent claude-code -y
Project install writes to
.claude/skills/gws-gmail-watch
Global install writes to
~/.claude/skills/gws-gmail-watch

Start a new session afterwards so the agent picks the skill up. In Claude Code you can also call it directly with /gws-gmail-watch.

What it does

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 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…

Excerpt from the skill's own SKILL.md. Read the full file on GitHub before installing: skills run with your agent's permissions.

Categories

Related skills

  • gws-gmail

    googleworkspace/cli

    Gmail: Send, read, and manage email.

    81K installs 32KSecurity
  • gws-gmail-send

    googleworkspace/cli

    Gmail: Send an email.

    74K installs 32KSecurity
  • gws-drive

    googleworkspace/cli

    Google Drive: Manage files, folders, and shared drives.

    74K installs 32KSecurity
  • gws-shared

    googleworkspace/cli

    gws CLI: Shared patterns for authentication, global flags, and output formatting.

    65K installs 32KDocumentationDataWriting
  • gws-calendar

    googleworkspace/cli

    Google Calendar: Manage calendars and events.

    60K installs 32KSecurity
  • gws-sheets

    googleworkspace/cli

    Google Sheets: Read and write spreadsheets.

    58K installs 32KSecurityData

← Search skills

/skills/googleworkspace/cli/gws-gmail-watch/