Cli gws-calendar-agenda
Google Calendar: Show upcoming events across all calendars.
install
source · Clone the upstream repo
git clone https://github.com/googleworkspace/cli
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/googleworkspace/cli "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/gws-calendar-agenda" ~/.claude/skills/googleworkspace-cli-gws-calendar-agenda && rm -rf "$T"
manifest:
skills/gws-calendar-agenda/SKILL.mdsource content
calendar +agenda
PREREQUISITE: Read
for auth, global flags, and security rules. If missing, run../gws-shared/SKILL.mdto create it.gws generate-skills
Show upcoming events across all calendars
Usage
gws calendar +agenda
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
| — | — | Show today's events |
| — | — | Show tomorrow's events |
| — | — | Show this week's events |
| — | — | Number of days ahead to show |
| — | — | Filter to specific calendar name or ID |
| — | — | 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
Tips
- Read-only — never modifies events.
- Queries all calendars by default; use --calendar to filter.
- Uses your Google account timezone by default; override with --timezone.
See Also
- gws-shared — Global flags and auth
- gws-calendar — All manage calendars and events commands