gws-calendar-agenda▌
googleworkspace/cli · updated Apr 8, 2026
Display upcoming events across all Google Calendars with flexible time range and filtering options.
- ›Query events by preset ranges (today, tomorrow, week) or custom day count, with optional filtering by calendar name or ID
- ›Respects your Google account timezone by default; override with IANA timezone flag for different regions
- ›Read-only operation; never modifies events or calendar data
- ›Requires gws binary and Google Calendar authentication via shared gws-shared skill
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
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.5★★★★★59 reviews- ★★★★★Layla Haddad· Dec 28, 2024
Registry listing for gws-calendar-agenda matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Nia Sharma· Dec 28, 2024
gws-calendar-agenda is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Dhruvi Jain· Dec 24, 2024
gws-calendar-agenda reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Amina Martin· Dec 12, 2024
I recommend gws-calendar-agenda for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Lucas Perez· Dec 8, 2024
Keeps context tight: gws-calendar-agenda is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Ira Rao· Dec 4, 2024
gws-calendar-agenda fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Yusuf Singh· Nov 27, 2024
gws-calendar-agenda has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Yusuf Iyer· Nov 19, 2024
Useful defaults in gws-calendar-agenda — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Kofi Sethi· Nov 19, 2024
Solid pick for teams standardizing on skills: gws-calendar-agenda is focused, and the summary matches what you get after install.
- ★★★★★Oshnikdeep· Nov 15, 2024
I recommend gws-calendar-agenda for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
showing 1-10 of 59