---

name: gws-calendar-agenda version: 1.0.0 description: "Google Calendar: Show upcoming events across all calendars." metadata: openclaw: category: "productivity" requires: bins: ["gws"] cliHelp: "gws calendar +agenda --help"

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

• gws-shared — Global flags and auth
• gws-calendar — All manage calendars and events commands