gws-gmail-watch

Monitor Gmail for new emails and stream them as NDJSON.

1|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/Porkbutts/jetaasc-events --skill gws-gmail-watch-porkbutts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-watch
Source: https://github.com/Porkbutts/jetaasc-events/tree/main/.agents/skills/gws-gmail-watch
Command: npx skills add https://github.com/Porkbutts/jetaasc-events --skill gws-gmail-watch-porkbutts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the process of monitoring your Gmail inbox for new emails and streaming them in a structured NDJSON format, making it easy to process email data programmatically.

Core Features & Use Cases

  • Real-time Email Monitoring: Continuously watch for new emails based on specified labels.
  • NDJSON Output: Stream email data in a machine-readable format for further processing.
  • Flexible Filtering: Filter emails by label IDs (e.g., INBOX, UNREAD).
  • Use Case: Integrate with a data pipeline to automatically log all incoming support emails into a database for analysis and response tracking.

Quick Start

Use the gws gmail watch command to monitor your inbox for new emails.

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 emails as NDJSON for a data pipeline?

You can stream new Gmail emails as NDJSON by using a monitoring command that watches your inbox and outputs new messages in a machine-readable format. This allows automated email processing and direct integration with data pipelines.

Can I filter which Gmail emails are monitored and streamed?

Yes, you can filter Gmail emails during monitoring by specifying label IDs such as INBOX or UNREAD. This ensures only messages matching your criteria are streamed as NDJSON for downstream processing.

Do I need Pub/Sub to automate Gmail monitoring and email streaming?

Yes, you need Pub/Sub resources to automate Gmail monitoring. The Skill requires Pub/Sub to handle new email notifications efficiently and stream the message data as NDJSON.

What is NDJSON used for when processing incoming emails automatically?

NDJSON is used to format incoming emails as structured, machine-readable data separated by newlines. This format allows automated systems to ingest and process email logs sequentially for analysis and tracking.

How do I log incoming support emails into a database automatically?

You can log incoming support emails into a database automatically by monitoring your Gmail inbox and streaming new messages as NDJSON. This structured output allows your data pipeline to ingest and record the email data directly.

What are the limitations of using Gmail automation for email processing?

The email monitoring automation depends on Pub/Sub resources and specific message formats. Users must ensure their data pipelines can process NDJSON and that their Gmail label filters are correctly configured to capture the desired messages.