gws-events-renew Skill: Keep Google Workspace Event Subscriptions Alive

Renews or reactivates Google Workspace event subscriptions before they expire.

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

gws-events-renew has your agent run gws events +renew to reactivate one subscription by name or to renew every subscription that expires within a time window (1 hour by default). SKILL.md says subscriptions expire if they are not renewed and suggests running the --all form from a cron job. It needs the gws program installed and signed in. It changes live subscriptions, so check the window before you run --all.

Good for

Developers who run Workspace event subscriptions and need them renewed
Admins who want a cron job to keep subscriptions from lapsing
Claude Code or Codex users who already run the gws program

Install gws-events-renew

Claude Code

Copy this prompt.

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

npx skills add https://github.com/googleworkspace/cli --skill gws-events-renew --skill gws-events --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 3 skills (gws-events-renew, gws-events, gws-shared) because gws-events-renew 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

Google Workspace Events: Renew/reactivate Workspace Events subscriptions.

Sections in SKILL.md

Usage
Flags
Examples
Tips
See Also

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,091 (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 gws-events
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
Documented setups: skills CLI, OpenClaw, Gemini CLI extension

What it includes

Reactivates one subscription
Takes a subscription name such as subscriptions/SUB_ID.
Write · gws events +renew --name
Renews every subscription expiring soon
Renews all subscriptions that expire within the --within window.
Write · gws events +renew --all
Sets the window for --all
Accepts values such as 1h, 30m or 2d. The default is 1h.
--within

From the official docs

Permissions

Medium risk

It changes the expiry of live Workspace event subscriptions and can touch many at once with --all. 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

--all renews every subscription in the window
A wide window such as 2d touches many subscriptions at once. Start with --name for one subscription, then widen it. github.com
A cron job runs without you watching
SKILL.md suggests --all from a cron job. A scheduled run uses your signed-in Google account, so use a narrow window and check what it renews. 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	Google Workspace Events access for the subscriptions you renew

Questions

What does gws-events-renew do?

Renews or reactivates Google Workspace event subscriptions before they expire.

How do I install gws-events-renew in Claude Code?

Use the install box above. It adds gws-events-renew together with gws-events, 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-renew 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-renew 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-renew safe?

It changes the expiry of live Workspace event subscriptions and can touch many at once with --all. The gws-shared skill tells the agent to confirm writes and to prefer --dry-run, but that is an instruction, not a lock. Start with one named subscription before you use --all.

Why do Workspace event subscriptions expire?

SKILL.md says subscriptions expire if they are not renewed periodically and suggests running --all from a cron job to keep them alive.

Can it fix a suspended subscription?

The parent gws-events skill lists a reactivate call for suspended subscriptions and says to fix the error that suspended it first. The +renew helper is described as renewing or reactivating subscriptions.

Information

updated Nov 2, 2026

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

googleworkspace/cli skills.sh

Sources

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

Show all 4