gws-events-subscribe

Subscribe to Google Workspace events and stream them as NDJSON.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/fishyer/skills --skill gws-events-subscribe-fishyer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-events-subscribe
Source: https://github.com/fishyer/skills/tree/main/skills/gws-events-subscribe
Command: npx skills add https://github.com/fishyer/skills --skill gws-events-subscribe-fishyer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gws, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the need for real-time monitoring and streaming of Google Workspace events, enabling users to stay updated with the latest activities within their workspace.

Core Features & Use Cases

  • Real-time Event Streaming: Monitor and stream Google Workspace events as they occur.
  • Custom Event Types: Subscribe to specific event types such as chat messages, file changes, etc.
  • Flexible Configuration: Configure subscription settings like target workspace, event types, and Pub/Sub resources.
  • Use Case: For instance, you can set up this Skill to notify you of new emails in your Google Workspace inbox in real-time.

Quick Start

Subscribe to chat messages in your Google Workspace by running: gws events +subscribe --target '//chat.googleapis.com/spaces/SPACE_ID' --event-types 'google.workspace.chat.message.v1.created'

Frequently Asked Questions about gws-events-subscribe

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stream Google Workspace events in real-time?

Stream Google Workspace events in real-time by using this Skill to subscribe to specific event types and output them continuously as NDJSON. You can monitor activities like chat messages or file changes as they occur.

Can I subscribe to specific event types like chat messages in Google Workspace?

Yes, you can subscribe to specific event types in Google Workspace, such as chat messages. The Skill allows flexible configuration to target specific workspaces and event types like 'google.workspace.chat.message.v1.created'.

Do I need Google Pub/Sub setup to monitor Google Workspace activities?

Yes, you need Google Pub/Sub setup and Google Workspace API access to monitor activities. The Skill relies on Pub/Sub resources to receive and stream real-time event updates from your target workspace.

What format are Google Workspace events streamed in?

Google Workspace events are streamed in NDJSON (Newline Delimited JSON) format. This format outputs each event as a separate JSON object on a new line, suitable for applications requiring real-time updates.

How do I monitor new emails in my Google Workspace inbox in real-time?

Monitor new emails in real-time by configuring a subscription to email event types. The Skill streams these Google Workspace events as NDJSON, enabling immediate notification and processing of incoming inbox activities.

What are the limitations of using NDJSON for real-time event streaming?

NDJSON streams events line-by-line, which is efficient for continuous processing but lacks batch envelope structures. This approach requires a stable Google Workspace API and Pub/Sub connection to maintain real-time event delivery without interruption.