Google Workspace CLI (gws)

One CLI over every Google Workspace API, with JSON output and agent skills for Calendar events, free/busy and agendas.

Operable ProductCLI Deterministic Rust CLI License: Apache-2.0

gws is a Rust CLI on the googleworkspace GitHub org that builds its command surface from Google's Discovery Service at runtime, so every Calendar v3 method (events, calendars, ACL, free/busy, settings) is a shell command with structured JSON output. It ships 100+ agent skills, a Gemini CLI extension and helper commands such as calendar +agenda and +insert. Google Calendar itself is free with a Google account.

Use it when

my whole calendar lives in Google and I want my agent to find a slot, book it and send invites from the terminal
I need scripted Calendar operations in CI or on a server with a service account and no browser

Gotchas

README: 'not an officially supported Google product' and breaking changes expected before v1.0
Unverified OAuth apps are capped at about 25 scopes, so log in with -s calendar rather than the recommended preset; you must add yourself as a test user
gws auth setup requires the gcloud CLI; otherwise create the OAuth client by hand
Google Workspace business plans are paid, but a free Google account is enough for Calendar

Last activity Aug 25, 2026. Fit: adaptable 0, operable 3.

Editions

Free · Free open source

Clonegit clone https://github.com/googleworkspace/cli
DownloadDownload
Installnpm install -g @googleworkspace/cli
Installbrew install googleworkspace-cli

For agents: JSON · Markdown

Operable: what an agent can drive

Interface

OfficialCLIpublished by the builderlocal

How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.

Docs: github.com/googleworkspace/cli
Tools: gws calendar events gws calendar freebusy query gws calendar +agenda gws calendar +insert

Reach

Partial coverage. 8 of 10 jobs reachable through the stated interface.

Job	Through the interface	Evidence
List, create, update and delete events	Reachable	skills/gws-calendar/SKILL.md: events list, insert, patch, update, delete
Query free/busy across calendars	Reachable	SKILL.md: freebusy query; recipe-find-free-time skill
Show an agenda across all calendars	Reachable	helper command gws calendar +agenda with timezone handling
Create an event from a text phrase	Reachable	SKILL.md: events quickAdd
Manage calendars and sharing	Reachable	SKILL.md: calendars insert/patch/delete, calendarList, acl insert/list
Expand recurring events	Reachable	SKILL.md: events instances
Watch for changes	Reachable	SKILL.md: events watch and channels stop; needs a public HTTPS endpoint to receive pushes
Reschedule and invite in bulk	Reachable	skills recipe-reschedule-meeting, recipe-batch-invite-to-event, recipe-create-events-from-sheet
Appointment schedules (booking pages)	Not reachable	not in the Calendar v3 Discovery surface, so not in gws
Attach a Google Meet link	Undetermined	conferenceData on events insert; gws-meet skill exists but not verified for calendar events

Code stack

Languages: Rust
Frameworks: none
Package manager: cargo
Database: none
Hosting target: binary
Built: Unknown (recorded, never ranked)

Model stack

Providers: any agent that can run a shell
Models: none
Keys you need: none
Prompts live in: skills/gws-calendar/SKILL.md skills/gws-calendar-agenda/SKILL.md skills/gws-calendar-insert/SKILL.md skills/recipe-find-free-time skills/recipe-reschedule-meeting skills/recipe-plan-weekly-schedule

Skills

Ships per-service skills (Drive, Gmail, Calendar, Docs, Chat, Admin) that teach an agent to drive the CLI; installable individually or as a set.

Kind: bundled
Paths: skills/gws-*/SKILL.md
Install: npx skills add https://github.com/googleworkspace/cli

Evidence and confidence

Field	Where it was seen	Confidence
formFactor	README: CLI binary from GitHub Releases, npm or Homebrew	95%
executionModel	the CLI makes API calls; no model at runtime (Model Armor sanitization is optional and external)	90%
operability	published on the googleworkspace GitHub organization; Calendar helper commands and skills in the repo	85%
editions	README: Apache-2.0 source, binaries, npm, brew, nix	95%
active	shortlist pushedAt 2026-08-25	–
reach		85%

Open questions

Official by organization but disclaimed as unsupported: does the Curator treat googleworkspace-org publication as official?
Provenance: CLAUDE.md and AGENTS.md sit at the repo root; how much of the code is agent-written is not stated

Sources

github.com/googleworkspace/cli sourcing:scheduling-staffing:vendor
github.com/googleworkspace/cli/blob/main/skills/gws-calendar/SKILL.md analysis:scheduling-staffing