gws-gmail-watch

Stream new Gmail messages as NDJSON via Google Cloud Pub/Sub.

Updated May 25, 2025
One-click install
npx skills add https://github.com/temple-slope/dotfiles --skill gws-gmail-watch-temple-slope
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail-watch
Source: https://github.com/temple-slope/dotfiles/tree/main/.agents/skills/gws-gmail-watch
Command: npx skills add https://github.com/temple-slope/dotfiles --skill gws-gmail-watch-temple-slope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail messages need to be processed by downstream systems; this skill streams new emails in NDJSON for automation.

Core Features & Use Cases

  • Real-time Gmail watch: detect new messages as they arrive and emit structured JSON lines.
  • NDJSON streaming: output each message as a separate JSON object for easy ingestion.
  • Use Case: integrate with data pipelines, chatops, or alerting systems that react to new emails.

Quick Start

Run the gws gmail +watch command 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 Gmail messages as NDJSON for a data pipeline?▼

You can stream Gmail messages as NDJSON by running the watch command, which detects new emails in real time and emits each message as a structured JSON line for downstream pipeline ingestion.

What is real-time Gmail watch and how does it work with Pub/Sub?▼

Real-time Gmail watch uses Google Cloud Pub/Sub integration to detect new messages as they arrive, pushing them to your downstream systems instead of requiring continuous API polling.

Do I need Google Cloud Pub/Sub integration to monitor a Gmail inbox?▼

Yes, Gmail push permissions and Google Cloud Pub/Sub integration are required to enable real-time inbox monitoring and stream new messages to your automation workflows.

Can I use NDJSON streaming to trigger automation pipelines for new emails?▼

Yes, NDJSON streaming outputs each new Gmail message as a separate JSON object, allowing chatops, alerting systems, and automation pipelines to easily ingest and react to incoming emails.

What is the best way to integrate new emails into analytics workflows?▼

Streaming new Gmail messages as NDJSON provides an easy-to-ingest structured format, making it an effective approach for feeding real-time email data directly into analytics workflows.

Why use NDJSON format for streaming Gmail messages instead of standard JSON?▼

NDJSON outputs each message as a separate JSON object on a new line, allowing downstream systems to parse and ingest continuous email streams incrementally without waiting for a complete JSON array.