Gws Calendar Agenda
googleworkspace/cliOfficial
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.
- installs
- 49.7K
- GitHub stars
- 31.9K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add googleworkspace/cli --skill gws-calendar-agenda --agent claude-codeInstalls into .claude/skills of the current project.
Files
calendar +agenda
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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
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
Sponsors
Details
- Repository
- github.com/googleworkspace/cli
- Categories
- CLI & Terminal, Office & Documents
