gws-gmail-watch

Stream Gmail new messages as NDJSON via Pub/Sub push integration.

4|2|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/73ai/openbotkit --skill gws-gmail-watch-73ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-watch
Source: https://github.com/73ai/openbotkit/tree/main/skills/gws-gmail-watch
Command: npx skills add https://github.com/73ai/openbotkit --skill gws-gmail-watch-73ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Stream Gmail new messages as NDJSON to enable real-time processing and easy downstream integration.

Core Features & Use Cases

  • Monitors Gmail inbox for new messages and streams them as NDJSON for consumption by pipelines, dashboards, or storage systems.
  • Filters by Gmail labels, and integrates with Pub/Sub topics/subscriptions for scalable delivery.
  • Supports optional local output (NDJSON files) through the output-dir flag and respects safety rules from gws-shared.

Quick Start

Run the gws gmail +watch command with your project, topic, and subscription to begin streaming 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 new messages as NDJSON for real-time processing?

You can stream Gmail new messages as NDJSON by running the watch command with your project, Pub/Sub topic, and subscription to enable real-time pipeline integration.

Can I filter Gmail messages by labels when streaming to NDJSON?

Yes, you can filter Gmail messages by labels when streaming to NDJSON, ensuring only specific categorized emails are pushed to your downstream notification pipelines or dashboards.

Do I need Pub/Sub to monitor my Gmail inbox for new messages?

Using Google Pub/Sub enables scalable Gmail push integration, but you can also configure polling intervals and output NDJSON files locally via the output-dir flag.

What is the best way to integrate Gmail inbox monitoring with downstream pipelines?

Streaming Gmail new messages as NDJSON is an effective way to integrate inbox monitoring with downstream pipelines, as it provides structured data for easy consumption by dashboards and storage systems.

Does Gmail streaming require specific auth or safety configurations?

Yes, Gmail streaming requires authentication and adheres to safety rules defined by gws-shared to ensure secure access when monitoring your inbox and outputting NDJSON files.