Skip to content
Get packs

Google Workspace Event Subscriber

Lets an agent subscribe to Google Workspace events and stream them as NDJSON via the gws CLI

Source Download skill
Repository
googleworkspace/cli
Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

This skill teaches an AI agent to use the gws command-line tool to listen for changes in Google Workspace, such as new chat messages in a Google Chat space. Events are delivered through Google Cloud Pub/Sub and printed as a stream of JSON lines, or saved as one JSON file per event. The skill also tells the agent to ask the user for confirmation before running the command, since it creates resources.

Great for

  • Developers building automations that react to Google Chat or other Workspace activity
  • Data or operations staff who want a live feed of Workspace events for monitoring

Skip it if

  • Users without a Google Cloud project and Workspace access, since setup will fail without them
  • Situations where a persistent listener running unattended is unwanted, because it keeps polling until stopped and resources persist unless --cleanup is used

Try asking

  • “Subscribe to new messages in a specific Google Chat space and stream them to my terminal”
  • “Listen for one batch of Workspace events on an existing Pub/Sub subscription and then exit”
  • “Subscribe to Chat message events, save each event as a JSON file in ./events, and clean up resources when done”
Step-by-step guide: how to use Google Workspace Event SubscriberInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    gws-events-subscribe.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip gws-events-subscribe.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip gws-events-subscribe.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Pass --once for a single test pull before running a long-lived subscription
  • Use --cleanup when finished so Pub/Sub resources do not persist, and reuse --subscription to reconnect later
  • Run gws generate-skills first if the shared prerequisite skill file is missing

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.