SkillsSKILLS
Productivity

gws-calendar-agenda▌

googleworkspace/cli · updated Apr 8, 2026

$npx skills add https://github.com/googleworkspace/cli --skill gws-calendar-agenda
summary

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
skill.md

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

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