gws-events Skill: Subscribe to Google Workspace Events From Your Agent

Lets your agent set up and manage Google Workspace event subscriptions with the gws command-line program.

Installs: 31.7K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

gws-events teaches your agent the gws events commands, which subscribe to Google Workspace events such as a new Chat message and manage those subscriptions. It points to two helper skills, +subscribe to stream events and +renew to keep subscriptions alive, and it lists the raw calls to create, list, update and delete a subscription. It runs only after you install the gws program and sign in to Google. Creating or deleting a subscription changes your Workspace setup, so read each command before you approve it.

Good for

Developers who want Workspace or Chat events streamed into an agent session
Admins who keep event subscriptions alive and want the commands at hand
Claude Code or Codex users who already run the gws program

Install gws-events

Claude Code

Copy this prompt.

Install the gws-events skill in Claude Code. Run this command:

npx skills add https://github.com/googleworkspace/cli --skill gws-events --skill gws-events-subscribe --skill gws-events-renew --skill gws-shared -a claude-code

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, gws installed and signed in.

Do the "First" and "Then" methods once before the skills command: they install gws and sign you in. The skills command adds 4 skills (gws-events, gws-events-subscribe, gws-events-renew, gws-shared) because gws-events reads gws-shared first and points to the others in the set. Without gcloud, use the manual OAuth setup in the README.

From the vendor's docs. Source.

What's in the skill

When it loads

Subscribe to Google Workspace events.

Sections in SKILL.md

Helper Commands
API Resources
message
operations
subscriptions
tasks
Discovering Commands

Key facts

Author: googleworkspace organization (repo owner)
Status: Not an officially supported Google product, per the README
License: Apache-2.0
Installs on skills.sh: 31,742 (Nov 2, 2026)
GitHub stars: 32,038 (Nov 2, 2026) (whole repo)
Last commit: Oct 30, 2026
What installs: 1 file, SKILL.md; it bundles no scripts
Needs: the gws program signed in to Google, plus gws-shared and the two helper skills
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
Documented setups: skills CLI, OpenClaw, Gemini CLI extension

What it includes

Streams Workspace events as lines of JSON
Listens on a Workspace resource such as a Chat space and prints each event. It has its own skill, gws-events-subscribe.
Write · gws events +subscribe
Renews or reactivates subscriptions
Keeps subscriptions from expiring. It has its own skill, gws-events-renew.
Write · gws events +renew
Creates a Workspace subscription
Starts a new subscription to events on a Workspace resource.
Write · gws events subscriptions create
Lists subscriptions or shows one
Shows which subscriptions exist and the details of one.
Network · gws events subscriptions list / get
Updates or renews a subscription
Changes a subscription or extends it.
Write · gws events subscriptions patch
Reactivates a suspended subscription
Sets a suspended subscription back to ACTIVE. SKILL.md says to fix the error that suspended it first.
Write · gws events subscriptions reactivate
Deletes a subscription
Removes a subscription for good.
Delete · gws events subscriptions delete
Streams task updates from an agent
A streaming call that returns task update events until the task is interrupted or finished.
Network · gws events message stream
Reads, cancels or follows a task
Checks a task's state, cancels it, or attaches a stream to a task in progress. A pushNotificationConfigs resource is also listed.
Write · gws events tasks get / cancel / subscribe
Polls a long-running operation
Returns the latest state of an operation so the agent can check on it.
Network · gws events operations get
Shows a method's parameters before the call
SKILL.md tells the agent to inspect a method first, then build the --params and --json flags from the output.
Read · gws schema events.<resource>.<method>

From the official docs

Permissions

Medium risk

It can create, change and delete event subscriptions in your Workspace account. Sign in with only the services you need and read each command before you approve it.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can create and delete subscriptions
subscriptions create, patch and delete change your Workspace setup. Read each command before you approve it. github.com
It runs as you, with the access you granted
gws uses your Google sign-in. Sign in with only the services you need, using the service filter the README shows. github.com
The project is in active development
The README says to expect breaking changes before v1.0. Re-read the install steps after you update gws. github.com

Technical details

Turning on read-only	No read-only switch in the skill. The gws-shared skill says to prefer --dry-run for destructive operations and to confirm write commands with you.
Talks to	Google Workspace Events API through gws
Sign-in and keys	gws sign-in. The README says credentials are encrypted at rest (AES-256-GCM) with the key kept in your OS keyring.
Scopes	Whatever Google services you grant when you sign in to gws

Questions

What does gws-events do?

Lets your agent set up and manage Google Workspace event subscriptions with the gws command-line program.

How do I install gws-events in Claude Code?

Use the install box above. It adds gws-events together with gws-events-subscribe, gws-events-renew, gws-shared in one step. You also need the gws program installed and signed in to Google first, and the box lists both steps.

Does gws-events work in the Claude app or Codex?

The install box has a Codex tab that uses the skills CLI's Codex target, but the repo README does not list Codex as a supported setup. The README documents no Claude app route, and every command runs the gws program in a terminal, so use Claude Code or another terminal agent.

Does gws-events need an API key?

No API key. It uses your Google sign-in through gws, and the README says you need a Google Cloud project for the sign-in credentials. gws auth setup can create one if you have the gcloud CLI.

Is gws-events safe?

It can create, change and delete event subscriptions in your Workspace account. The gws-shared skill tells the agent to confirm write and delete commands and to prefer --dry-run, but that is an instruction, not a lock. Read each command before you approve it and sign in with only the services you need.

What is the difference between gws-events and gws-events-subscribe?

gws-events is the overview of every gws events command and points to the two helper skills. gws-events-subscribe covers only the streaming helper and its flags. The install box adds both.

What does it do with the event data?

The streaming helper prints each event as a line of JSON, so the agent reads it in your session. Use a Chat space or resource you are comfortable sharing with your AI provider.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/gws-events

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

googleworkspace/cli README · github.com
skills CLI commands · github.com
gws-events SKILL.md · github.com
gws-shared SKILL.md · github.com