gws-gmail-watch

Monitor Gmail for new messages and stream them as NDJSON.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/vikingokft/vikingo-studio-skills --skill gws-gmail-watch-vikingokft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-watch
Source: https://github.com/vikingokft/vikingo-studio-skills/tree/main/google/gws-gmail-watch
Command: npx skills add https://github.com/vikingokft/vikingo-studio-skills --skill gws-gmail-watch-vikingokft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates monitoring of Gmail for new messages and streams them as NDJSON.

Core Features & Use Cases

  • Real-time Gmail watch and NDJSON streaming to downstream systems or files.
  • Filter by Gmail labels (INBOX, UNREAD) and customize output with --output-dir and --msg-format.
  • Quick integration with Pub/Sub workflows via project/topic/subscription settings for event-driven automation.

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 in real-time?

Stream new Gmail messages as NDJSON by running the gws CLI with the watch command, applying label filters and output directory options to route data directly into downstream ingestion pipelines.

Can I filter Gmail messages by INBOX or UNREAD labels before streaming?

Filter Gmail messages by labels such as INBOX or UNREAD using command options, ensuring only targeted messages are streamed as NDJSON to your event-driven automation workflows.

Do I need Pub/Sub configuration to automate Gmail monitoring?

Pub/Sub configuration is required to enable event-driven Gmail monitoring, utilizing project, topic, and subscription settings to trigger automated streaming workflows for new messages.

What is the best way to integrate Gmail into a real-time ingestion pipeline?

Integrate Gmail into real-time ingestion pipelines by configuring the gws CLI watch command with Pub/Sub settings, streaming new messages as NDJSON directly to files or downstream systems.

How does the poll-interval option affect Gmail message streaming?

The poll-interval option controls the frequency of checking Gmail for new messages, balancing streaming latency against API usage to optimize your real-time NDJSON ingestion workflow.

What output formats are supported when watching Gmail messages?

Watched Gmail messages are streamed as NDJSON, with the msg-format option allowing customization of the message content structure saved to the specified output directory.