Gws Events

A straightforward wrapper around Google Workspace Events API that lets you subscribe to real-time notifications from Gmail, Drive, Calendar, and other Workspace apps. You can create subscriptions, stream events as NDJSON, and manage subscription lifecycles without wrestling with OAuth flows or webhook endpoints. The helper commands make it easy to set up event streams and renew expiring subscriptions. Most useful for building automation workflows that react to document changes, new emails, or calendar updates. Requires the gws CLI and proper Workspace admin permissions, but once configured it handles the streaming complexity for you.

skills.sh installs: 32.1K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill gws-events --agent claude-code

Installs into .claude/skills of the current project.

Files

events (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws events <resource> <method> [flags]

Helper Commands

Command	Description
`+subscribe`	Subscribe to Workspace events and stream them as NDJSON
`+renew`	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.