gws-calendar-agenda Skill for Claude: Show Upcoming Calendar Events

Lets Claude show your upcoming Google Calendar events across all your calendars, using the gws command-line tool.

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

The skill teaches the agent one command, gws calendar +agenda. You can ask for today, tomorrow, this week, or the next N days, narrow it to one calendar by name or ID, and override the time zone. SKILL.md says it only reads and never modifies events.

It needs the gws CLI installed and signed in to your Google account, and SKILL.md tells the agent to read the gws-shared skill first for sign-in and security rules.

Good for

Anyone who wants Claude to check their schedule without opening Calendar
Developers already using the gws CLI who want it driven by an agent

Install gws-calendar-agenda

Claude Code

Copy this prompt.

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

npm install -g @googleworkspace/cli
gws auth setup
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-shared
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-calendar-agenda

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+, Google Cloud project, Google account.

This skill only works with the gws command-line tool on your PATH, and its SKILL.md tells the agent to read the gws-shared skill first, so install both. gws auth setup needs the gcloud CLI; without it, use the manual OAuth steps in the README. If Google limits the sign-in screen, pick only the service you need, for example gws auth login -s drive,gmail,sheets.

From the project README. Source.

What's in the skill

When it loads

Google Calendar: Show upcoming events across all calendars.

Sections in SKILL.md

Usage
Flags
Examples
Tips
See Also

Key facts

Author: googleworkspace
Repository: googleworkspace/cli
License: Apache-2.0
Installs on skills.sh: 50,191 (Nov 2, 2026)
GitHub stars: 32,038 (Nov 2, 2026)
Last repo commit: Oct 30, 2026
What installs: 1 file including SKILL.md (the folder holds SKILL.md only)
Needs: The gws CLI on your PATH, a Google sign-in, and the gws-shared skill (read first, per SKILL.md)
Official status: The README says gws is not an officially supported Google product

What it includes

Shows upcoming events across all your calendars
The base command. With no flags it queries all calendars. SKILL.md says it is read-only and never modifies events.
Try: “What is on my calendar this week?”
Runs code · gws calendar +agenda
Picks the window: today, tomorrow, this week, or N days ahead
Use --days with a number for a custom range.
Try: “Show my agenda for the next 3 days”
Read · --today / --tomorrow / --week / --days
Limits the list to one calendar by name or ID
Without it, all calendars are queried.
Try: “Only show events from my 'Work' calendar”
Read · --calendar
Overrides the time zone with an IANA name such as America/Denver
By default it uses your Google account time zone.
Read · --timezone
The SKILL.md tells the agent to read gws-shared for sign-in, flags and security rules
If gws-shared is missing, SKILL.md says to run gws generate-skills to create it.
Files · Read gws-shared first

From the official docs

Permissions

Low risk

It only reads your calendar, but event titles and details it returns become part of your conversation.

What it can do

Read your data
Create and change things
Delete things
Read-only modeHow to turn it on

Watch out for

Needs a Google sign-in on this machine
You sign in once with gws auth. Choose only the Calendar service when Google asks for access.
Event details enter your chat
The agenda output is read by the model. Skip it on a shared or logged session if your calendar holds private entries.

Technical details

Turning on read-only	The SKILL.md describes this command as read-only.
Talks to	Google Workspace APIs, called by the gws CLI
Sign-in and keys	The gws CLI encrypts saved Google credentials (AES-256-GCM) with a key in your OS keyring, or in ~/.config/gws/.encryption_key when the file backend is set.
Scopes	Only the Google service this command touches, chosen when you run gws auth login

Questions

What does gws-calendar-agenda do?

It shows your upcoming Google Calendar events across all calendars. You pick today, tomorrow, this week or a number of days, and can filter to one calendar or change the time zone.

How do I install gws-calendar-agenda?

Use the install box above, which has tabs for Claude Code, Codex and the skills CLI. Each sets up the gws CLI, signs you in to Google, and installs this skill together with gws-shared, because SKILL.md tells the agent to read gws-shared first for sign-in, global flags and security rules. There is no Claude app upload tab: the skill runs a gws command, and the README documents installing gws as a binary, npm, cargo, Nix or Homebrew install on your own machine.

Does gws-calendar-agenda need an API key?

SKILL.md names no API key. The gws CLI signs in with your Google account through OAuth, and the README says it needs a Google Cloud project for the OAuth credentials. A service account is the documented alternative for servers.

Is gws-calendar-agenda safe to use?

SKILL.md describes the command as read-only and says it never modifies events. It prints your event details, which the model then reads, and sign-in goes through your own Google account.

Is this an official Google skill?

It lives in the googleworkspace GitHub organization, but the README says gws is not an officially supported Google product and that the project is under active development with breaking changes expected before v1.0.

gws-calendar-agenda vs gws-calendar?

gws-calendar-agenda is the single helper for showing upcoming events. The gws-calendar skill is the full command set: its SKILL.md lists this helper plus +insert and the calendar API resources such as acl and calendarList.

Information

updated Nov 2, 2026

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

googleworkspace/cli skills.sh

Sources

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

Show all 7

googleworkspace/cli README · github.com
gws-shared SKILL.md · github.com
Codex skills docs · learn.chatgpt.com
skills CLI commands · github.com
gws-calendar-agenda SKILL.md · github.com
gws-calendar-agenda on skills.sh · skills.sh
gws-calendar SKILL.md · github.com