Skip to content
cccskills
FreePublished on GitHub

gws-events-subscribe

Receive selected Google Workspace events and stream them as NDJSON, a format with one JSON record per line. Choose event types, use an existing subscription, or save each event to a separate file.

OriginalShow the original description

Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON.

See how to install

Good for

  • Receive notifications when messages are created in Google Chat
  • Fetch events once from an existing subscription
  • Save each received event as a separate JSON file

Files included (1)

  • SKILL.md2.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

events +subscribe

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Subscribe to Workspace events and stream them as NDJSON

Usage

gws events +subscribe

Flags

FlagRequiredDefaultDescription
--target——Workspace resource URI (e.g., //chat.googleapis.com/spaces/SPACE_ID)
--event-types——Comma-separated CloudEvents types to subscribe to
--project——GCP project ID for Pub/Sub resources
--subscription——Existing Pub/Sub subscription name (skip setup)
--max-messages—10Max messages per pull batch (default: 10)
--poll-interval—5Seconds between pulls (default: 5)
--once——Pull once and exit
--cleanup——Delete created Pub/Sub resources on exit
--no-ack——Don't auto-acknowledge messages
--output-dir——Write each event to a separate JSON file in this directory

Examples

gws events +subscribe --target '//chat.googleapis.com/spaces/SPACE' --event-types 'google.workspace.chat.message.v1.created' --project my-project
gws events +subscribe --subscription projects/p/subscriptions/my-sub --once
gws events +subscribe ... --cleanup --output-dir ./events

Tips

  • Without --cleanup, Pub/Sub resources persist for reconnection.
  • Press Ctrl-C to stop gracefully.

[!CAUTION] This is a write command — confirm with the user before executing.

See Also

  • gws-shared — Global flags and auth
  • gws-events — All subscribe to google workspace events commands

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Retrieve Google Workspace audit logs, which record account activity, and usage reports through gws. Review activity in applications such as the Admin console and Google Drive, or inspect statistics for the organization, users, and entities.

  • Reviewing Admin console and Google Drive activity
  • Checking organization usage statistics
  • Retrieving usage reports for users
googleworkspace/cli31.7KUpdated Oct 7, 2026

gws-calendar

FreeSummary

Manage Google Calendar events and calendars, including creating, updating, and deleting events. View upcoming events across calendars, check availability, and manage the permissions that control who can access a calendar.

  • Creating, updating, or deleting calendar events
  • Viewing upcoming events across multiple calendars
  • Checking availability across calendars
googleworkspace/cli31.7KUpdated Oct 7, 2026

View upcoming Google Calendar events across all calendars in one agenda. Check today, tomorrow, this week, or a chosen number of days, with options to filter calendars and change the display time zone.

  • Checking today's events across multiple calendars
  • Reviewing tomorrow's or this week's schedule
  • Listing the next three days on a work calendar
googleworkspace/cli31.7KUpdated Oct 7, 2026

Create a Google Calendar event with a title and start and end times. You can also choose a calendar, add a location and description, invite attendees, and include a Google Meet link.

  • Adding a meeting with a specified start and end time
  • Creating an event with attendees
  • Scheduling an online meeting with a Google Meet link
googleworkspace/cli31.7KUpdated Oct 7, 2026

gws-chat

FreeSummary

Manage Google Chat spaces, the places where conversations happen, and their messages through the gws command-line tool. Create or update spaces, add members, send messages, and upload or download attachments.

  • Create a Google Chat space with initial members
  • List spaces and update their details
  • Send messages to a space
googleworkspace/cli31.7KUpdated Oct 7, 2026

gws-chat-send

FreeSummary

Send plain text messages to a specified Google Chat space using the gws command line tool. Use it for team updates and announcements, with guidance on finding space identifiers and confirming messages before sending.

  • Sending a team announcement
  • Sharing a progress update in a space
  • Finding the destination space before sending
googleworkspace/cli31.7KUpdated Oct 7, 2026

See all skills by googleworkspace

Report a problem with this skill