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.