gws-gmail-watch

Watch Gmail for new messages and stream them as NDJSON.

8|3|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/haberlah/dotfiles-claude --skill gws-gmail-watch-haberlah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-watch
Source: https://github.com/haberlah/dotfiles-claude/tree/main/skills/gws-gmail-watch
Command: npx skills add https://github.com/haberlah/dotfiles-claude --skill gws-gmail-watch-haberlah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Stream Gmail inbox activity in real time by watching for new messages and exporting them as newline-delimited JSON for downstream processing and analytics.

Core Features & Use Cases

  • Watches Gmail for new messages and streams each message as NDJSON for immediate ingestion into pipelines.
  • Supports optional filtering via Gmail label IDs (e.g., INBOX, UNREAD) to constrain the stream.
  • Integrates with gws tooling to enable rapid setup and deployment in Google Cloud environments.

Quick Start

Run gws gmail +watch to start streaming new Gmail messages as NDJSON.

Frequently Asked Questions about gws-gmail-watch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stream new Gmail messages as NDJSON for a data pipeline?

You can stream new Gmail messages as NDJSON by running a watch command that monitors your inbox in real time and exports each message directly into your pipeline. This enables immediate downstream processing.

Can I filter the Gmail message stream to only watch specific labels?

Yes, you can constrain the Gmail message stream by using optional label ID filtering, such as INBOX or UNREAD, to ensure only messages matching those specific labels are exported as NDJSON.

Does this Gmail watch tool support Google Cloud Pub/Sub integration?

Yes, the tool supports Pub/Sub integration within gws environments, allowing you to deploy real-time email ingestion workflows rapidly and stream NDJSON directly into Google Cloud data pipelines.

What is the best way to monitor Gmail for new messages in real time?

The best way to monitor Gmail for new messages in real time is using a watch-based streaming approach that continuously exports incoming emails as newline-delimited JSON, making them instantly available for analytics workflows.

Do I need a specific environment to run the Gmail watch streaming tool?

You need to operate within gws tooling environments to run the Gmail watch command, which is specifically designed to enable rapid setup and deployment for real-time email streaming in Google Cloud.