Gws Calendar Agenda

A straightforward Google Calendar viewer that pulls upcoming events from all your calendars at once. Perfect for those quick "what's on my schedule" checks without opening a browser. The filtering options are practical: you can scope to today, tomorrow, or the next week, or drill down to specific calendars and custom day ranges. Timezone override is handy if you're traveling or coordinating across zones. It's read-only, so no risk of accidentally modifying anything. The table format makes it easy to scan multiple events quickly, which beats the cramped mobile calendar view when you just need a overview.

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

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

calendar +agenda

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

Show upcoming events across all calendars

Usage

gws calendar +agenda

Flags

Flag	Required	Default	Description
`--today`	—	—	Show today's events
`--tomorrow`	—	—	Show tomorrow's events
`--week`	—	—	Show this week's events
`--days`	—	—	Number of days ahead to show
`--calendar`	—	—	Filter to specific calendar name or ID
`--timezone`	—	—	IANA timezone override (e.g. America/Denver). Defaults to Google account timezone.

Examples

gws calendar +agenda
gws calendar +agenda --today
gws calendar +agenda --week --format table
gws calendar +agenda --days 3 --calendar 'Work'
gws calendar +agenda --today --timezone America/New_York