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.