gws-events-subscribe

Subscribe to Google Workspace events and stream them as NDJSON via Pub/Sub.

30.3k|1.8k|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/googleworkspace/cli --skill gws-events-subscribe-googleworkspace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-events-subscribe
Source: https://github.com/googleworkspace/cli/tree/main/skills/gws-events-subscribe
Command: npx skills add https://github.com/googleworkspace/cli --skill gws-events-subscribe-googleworkspace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the process of subscribing to and receiving real-time event notifications from Google Workspace services, eliminating the need for manual polling or complex webhook configurations.

Core Features & Use Cases

  • Real-time Event Streaming: Subscribe to specific Google Workspace events (e.g., new messages in Google Chat) and receive them as NDJSON over Pub/Sub.
  • Flexible Configuration: Configure target resources, event types, GCP projects, and Pub/Sub subscriptions.
  • Use Case: Monitor a specific Google Chat space for new messages and stream them to a data processing pipeline for analysis or archival.

Quick Start

Subscribe to new message events in a Google Chat space and stream them to a specified project and subscription.

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?▼

To stream Google Workspace events in real-time, you can subscribe to specific activities like new messages or calendar updates and receive them as NDJSON using Google Cloud Pub/Sub. This eliminates manual polling by pushing events directly to your configured subscription.

How do I configure Pub/Sub notifications for Google Chat messages?▼

Configuring Pub/Sub notifications for Google Chat messages requires setting up a target Google Chat space, selecting new message event types, and specifying your GCP project and Pub/Sub subscription details for message delivery.

Do I need a GCP project to subscribe to Google Workspace activities?▼

Yes, you need a GCP project to subscribe to Google Workspace activities. The Skill relies on Google Cloud Pub/Sub to deliver real-time event streams, requiring you to configure your GCP project and Pub/Sub subscription details to receive the NDJSON output.

What is the best way to monitor Google Workspace file changes without polling?▼

The best way to monitor Google Workspace file changes without polling is using a Pub/Sub subscription to stream events. This approach pushes real-time notifications for file changes directly to your data pipeline as NDJSON, avoiding manual webhook configurations.

Can I stream Google Workspace calendar updates to a data processing pipeline?▼

Yes, you can stream Google Workspace calendar updates to a data processing pipeline. By configuring target resources and event types, the Skill delivers calendar updates as NDJSON over Google Cloud Pub/Sub for real-time analysis or archival.

What format does the Pub/Sub event stream use for Google Workspace notifications?▼

The Pub/Sub event stream uses NDJSON format for Google Workspace notifications. This structured format allows you to easily ingest real-time activities, such as new messages or file changes, directly into downstream data processing pipelines.