Gws Calendar

A solid wrapper around Google Calendar's v3 API that handles the authentication headaches for you. Covers the full spectrum from basic event CRUD to calendar sharing permissions and free/busy queries. The helper commands like `+agenda` and `+insert` save you from wrestling with raw API parameters for common tasks. What I appreciate is the `gws schema` command that shows you exactly what parameters each method expects before you make the call. If you're building anything that needs to read or manipulate Google Calendar data programmatically, this beats writing your own OAuth flow and API client from scratch.

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

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

calendar (v3)

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

gws calendar <resource> <method> [flags]

Helper Commands

Command	Description
`+insert`	create a new event
`+agenda`	Show upcoming events across all calendars

API Resources

acl

delete — Deletes an access control rule.
get — Returns an access control rule.
insert — Creates an access control rule.
list — Returns the rules in the access control list for the calendar.
patch — Updates an access control rule. This method supports patch semantics.
update — Updates an access control rule.
watch — Watch for changes to ACL resources.

calendarList

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Details

Repository: github.com/googleworkspace/cli
Categories: CLI & Terminal, Office & Documents