events +subscribe
SkillDev toolsOnce added, your AI can subscribe to events in Google Workspace and receive them as they happen, such as new chat messages. Events arrive as a continuous NDJSON stream, one event per line, giving your AI a live feed of Workspace activity to work from.
Available today. Use it from your connected AI after setup.
No other account needed.
After adding it, tell your AI which Google Workspace events you want to follow. It will subscribe and start streaming them as they arrive.
Then ask your AI: use the events +subscribe skill
What your AI can do with it
- Subscribe to Google Workspace events such as new chat messages
- Receive events continuously as they happen
- Stream events as NDJSON, one event per line
- Feed incoming events into other steps your AI is running
What this skill tells your AI
The instructions your AI receives, as published by googleworkspace/cli in skills/gws-events-subscribe/SKILL.md and read by ahel’s review.
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Subscribe to Workspace events and stream them as NDJSON
Usage
gws events +subscribe
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--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 | — | 10 | Max messages per pull batch (default: 10) |
--poll-interval | — | 5 | Seconds 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
Signals
- GitHub stars
- 31k
- Forks
- 2k
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
gws-events-subscribe- Source
- github.com/googleworkspace/cli