gws-calendar skill for Claude Code: manage Google Calendar from the gws CLI

Lets your agent manage Google Calendar events, calendars and free/busy checks through the gws command line tool.

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

gws-calendar teaches the agent to run Google Calendar commands with the gws tool. It lists the calendar resources it can work with (events, calendars, calendar list, access rules, free/busy, colors and settings) and shows how to look up a method before calling it.

It needs the gws tool installed, a Google sign-in and the gws-shared skill, which it names as a prerequisite. Two helper commands, create an event and show the agenda, come as separate skills. Some of the commands can delete events and calendars.

Good for

People who want an agent to read or create calendar events
Developers scripting Google Calendar from the terminal
Teams checking free/busy time across calendars

Install gws-calendar

Claude Code

Copy this prompt.

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

npm install -g @googleworkspace/cli

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 18+.

gws-calendar tells the agent to read gws-shared first, and its two helper commands are the gws-calendar-insert and gws-calendar-agenda skills, so install all four. Or run npx skills add https://github.com/googleworkspace/cli to take every gws skill at once. Unverified OAuth apps are limited to about 25 scopes, so sign in with gws auth login -s calendar rather than the recommended preset.

From the project README. Source.

What's in the skill

When it loads

Google Calendar: Manage calendars and events.

Sections in SKILL.md

Helper Commands
API Resources
acl
calendarList
calendars
channels
colors
events
freebusy
settings
Discovering Commands

Key facts

Author: googleworkspace (repo owner)
Installs on skills.sh: 61,945 (Nov 2, 2026)
GitHub stars: 32,038 on the cli repo (Nov 2, 2026)
License: Apache-2.0
Last commit: 2026-10-30
What installs: 1 file: SKILL.md; it points to gws-calendar-insert and gws-calendar-agenda for the two helper commands
Needs: The gws CLI on PATH, a Google sign-in, and the gws-shared skill (named as a prerequisite)
Works in: Agents the skills CLI supports, OpenClaw and Gemini CLI (extension), per the README
Version in file: 0.22.5

What it includes

Read gws-shared first for auth, flags and security rules
If it is missing, run gws generate-skills to create it.
Read · Prerequisite
Create a new event (separate skill: gws-calendar-insert)
Takes a summary, start and end time, and optional location, attendees and Meet link.
Runs code · gws calendar +insert
Show upcoming events across all calendars (separate skill: gws-calendar-agenda)
Flags for today, tomorrow, week, days, calendar and time zone.
Runs code · gws calendar +agenda
list, get, insert, update, patch, delete, move, import, quickAdd, instances, watch
The main resource for working with calendar events.
Delete · events
get, insert, patch, update, delete and clear
clear deletes all events on a primary calendar.
Delete · calendars
Add, remove and list calendars on a user list
Includes get, patch, update and watch.
Runs code · calendarList
List, get, insert, update, patch, delete and watch access rules
Controls who can see a calendar.
Delete · acl
query returns free/busy information for a set of calendars
Checks availability.
Runs code · freebusy
Read user settings and color definitions; stop watch channels
Small helper resources.
Runs code · settings, colors and channels
gws calendar --help and gws schema calendar.resource.method
Look up required params before calling a method.
Runs code · Discovering commands

From the official docs

Permissions

Medium risk

It runs calendar commands as your Google account, and some of them delete events or change sharing. Use --dry-run first and approve each write yourself.

What it can do

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

Watch out for

It can delete events and whole calendars
The resource list includes deleting events and calendars, and clearing all events on a primary calendar. Ask for --dry-run first and approve each delete yourself.
It can change who sees a calendar
The acl resource inserts, updates and deletes access rules. Check any sharing change before it runs.
The CLI is not an official Google product
The README says it is not officially supported and expects breaking changes before v1.0.

Technical details

Talks to	Google Calendar API
Sign-in and keys	Per the README, gws login credentials are encrypted at rest (AES-256-GCM) with the key held in your OS keyring, or in ~/.config/gws/.encryption_key when the file backend is chosen.

Questions

What does gws-calendar do?

It lets Claude run Google Calendar commands through the gws tool: list and create events, check free/busy, manage calendars and access rules. Everything runs as your Google account.

How do I install gws-calendar?

Use the install box above. You need the gws tool and a Google sign-in first, and the gws-shared skill that the file names as its prerequisite. The box installs the four related skills together.

Can it delete my events?

Yes. The resource list includes deleting events and calendars, and calendars clear removes all events on a primary calendar. The gws-shared rules say to confirm before write or delete commands and to use --dry-run first.

How do I add or view events quickly?

Use the two helper skills: gws-calendar-insert creates an event, and gws-calendar-agenda shows upcoming events across calendars, with flags like --today, --week and --timezone.

Does it need Google Cloud setup?

Yes. The README says the gws tool needs OAuth credentials, usually from a Google Cloud project, created with gws auth setup or a manual setup in the console.

Is it an official Google product?

Not officially supported. The README says gws is not an officially supported Google product.

Does it work in the Claude app?

This page shows no Claude app route. The skill drives the gws command line tool, which has to be installed and signed in on the machine that runs the commands, and the README documents no Claude app setup. Use Claude Code, Codex or another agent that runs commands on your computer.

Information

updated Nov 2, 2026

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

googleworkspace/cli skills.sh

Sources

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

Show all 5

gws-calendar SKILL.md · github.com
googleworkspace/cli README · github.com
gws-calendar-insert SKILL.md · github.com
gws-calendar-agenda SKILL.md · github.com
skills CLI commands · github.com