gws-calendar-agenda
googleworkspace/cli
View upcoming events across all Google Calendars with flexible time range filtering.
What is gws-calendar-agenda?
Displays upcoming events from all your Google Calendars in a single view. Use this to quickly check your schedule for today, tomorrow, a specific week, or any number of days ahead, with optional filtering by calendar and timezone.
- Show upcoming events across all calendars by default
- Filter events by specific time ranges (today, tomorrow, week, or custom days)
- Filter to a single calendar by name or ID
- Override timezone for event display
- Read-only access—never modifies events
How to install gws-calendar-agenda
npx skills add null --skill gws-calendar-agenda- Google Workspace account with Calendar access
- gws CLI installed and authenticated (see gws-shared/SKILL.md)
How to use gws-calendar-agenda
- 1.Run `gws calendar +agenda` to see upcoming events across all calendars
- 2.Add `--today`, `--tomorrow`, or `--week` to limit the time range
- 3.Use `--days N` to show events for a specific number of days ahead
- 4.Add `--calendar 'Calendar Name'` to filter to a single calendar
- 5.Add `--timezone America/Denver` (or other IANA timezone) to override your account timezone
Use cases
- Check your full agenda for the day before starting work
- Review the week ahead to plan your schedule
- Look at the next 3 days while traveling in a different timezone
- Filter to only your Work calendar to see professional commitments
- Quickly verify availability before scheduling a meeting
- Anyone using Google Workspace who needs quick agenda visibility
- Busy professionals managing multiple calendars
- Remote workers coordinating across time zones
- Teams coordinating schedules
gws-calendar-agenda FAQ
No, this is read-only. It only displays events without making any changes.
Use the `--calendar` flag with the calendar name or ID, e.g., `gws calendar +agenda --calendar 'Work'`.
Yes, use `--timezone` with an IANA timezone code like `America/New_York`. By default it uses your Google account timezone.
It shows all upcoming events across all your calendars from now onwards.
Yes, you can combine flags like `--week --calendar 'Work' --timezone America/Denver`.
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: gws-calendar-agenda description: "Google Calendar: Show upcoming events across all calendars." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws calendar +agenda --help"
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
Related skills
More from googleworkspace/cli and the wider catalog.
gws-gmail
Send, read, and manage Gmail emails via Google Workspace CLI.
gws-drive
Manage Google Drive files, folders, and shared drives via CLI.
gws-docs
Read and write Google Docs via command line.
gws-calendar
Manage Google Calendar events, calendars, and access control via CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-gmail-send
Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.