Gws Events
Wire an agent or script to subscribe, stream, and renew Google Workspace event feeds via the `gws events` CLI.
Install
npx skills add https://github.com/googleworkspace/cli --skill gws-eventsWhat is this skill?
- Documents `gws events <resource> <method>` for subscriptions, long-running operations, and streaming task updates
- Points to `+subscribe` helper for Workspace events as NDJSON and `+renew` for subscription lifecycle
- Requires `gws` binary and shared `gws-shared` auth, flags, and security rules
- Links to official Google Workspace Events guides for create/delete subscription flows
- OpenClaw metadata pins category productivity and documents `gws events --help`
Adoption & trust: 16.2k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
Recommended Skills
Agent Browservercel-labs/agent-browser
Lark Imlarksuite/cli
Lark Calendarlarksuite/cli
Lark Sheetslarksuite/cli
Lark Vclarksuite/cli
Lark Contactlarksuite/cli
Journey fit
Primary fit
Workspace event subscriptions are integration work you do while connecting automations to Gmail, Drive, Calendar, and related APIs—not a launch or growth tactic. The skill documents `gws events` resources (subscriptions create/delete, operations poll, message stream) and helper skills for NDJSON streaming and renewal.
Common Questions / FAQ
Is Gws Events safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.
SKILL.md
READMESKILL.md - Gws Events
# events (v1) > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. ```bash gws events <resource> <method> [flags] ``` ## Helper Commands | Command | Description | |---------|-------------| | [`+subscribe`](../gws-events-subscribe/SKILL.md) | Subscribe to Workspace events and stream them as NDJSON | | [`+renew`](../gws-events-renew/SKILL.md) | Renew/reactivate Workspace Events subscriptions | ## API Resources ### message - `stream` — SendStreamingMessage is a streaming call that will return a stream of task update events until the Task is in an interrupted or terminal state. ### operations - `get` — Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service. ### subscriptions - `create` — Creates a Google Workspace subscription. To learn how to use this method, see [Create a Google Workspace subscription](https://developers.google.com/workspace/events/guides/create-subscription). - `delete` — Deletes a Google Workspace subscription. To learn how to use this method, see [Delete a Google Workspace subscription](https://developers.google.com/workspace/events/guides/delete-subscription). - `get` — Gets details about a Google Workspace subscription. To learn how to use this method, see [Get details about a Google Workspace subscription](https://developers.google.com/workspace/events/guides/get-subscription). - `list` — Lists Google Workspace subscriptions. To learn how to use this method, see [List Google Workspace subscriptions](https://developers.google.com/workspace/events/guides/list-subscriptions). - `patch` — Updates or renews a Google Workspace subscription. To learn how to use this method, see [Update or renew a Google Workspace subscription](https://developers.google.com/workspace/events/guides/update-subscription). - `reactivate` — Reactivates a suspended Google Workspace subscription. This method resets your subscription's `State` field to `ACTIVE`. Before you use this method, you must fix the error that suspended the subscription. This method will ignore or reject any subscription that isn't currently in a suspended state. To learn how to use this method, see [Reactivate a Google Workspace subscription](https://developers.google.com/workspace/events/guides/reactivate-subscription). ### tasks - `cancel` — Cancel a task from the agent. If supported one should expect no more task updates for the task. - `get` — Get the current state of a task from the agent. - `subscribe` — TaskSubscription is a streaming call that will return a stream of task update events. This attaches the stream to an existing in process task. If the task is complete the stream will return the completed task (like GetTask) and close the stream. - `pushNotificationConfigs` — Operations on the 'pushNotificationConfigs' resource ## Discovering Commands Before calling any API method, inspect it: ```bash # Browse resources and methods gws events --help # Inspect a method's required params, types, and defaults gws schema events.<resource>.<method> ``` Use `gws schema` output to build your `--params` and `--json` flags.