1---
2name: gws-calendar-agenda
3description: "Google Calendar: Show upcoming events across all calendars."
4metadata:
5  version: 0.22.5
6  openclaw:
7    category: "productivity"
8    requires:
9      bins:
10        - gws
11    cliHelp: "gws calendar +agenda --help"
12---
13 
14# calendar +agenda
15 
16> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
17 
18Show upcoming events across all calendars
19 
20## Usage
21 
22```bash
23gws calendar +agenda
24```
25 
26## Flags
27 
28| Flag | Required | Default | Description |
29|------|----------|---------|-------------|
30| `--today` | — | — | Show today's events |
31| `--tomorrow` | — | — | Show tomorrow's events |
32| `--week` | — | — | Show this week's events |
33| `--days` | — | — | Number of days ahead to show |
34| `--calendar` | — | — | Filter to specific calendar name or ID |
35| `--timezone` | — | — | IANA timezone override (e.g. America/Denver). Defaults to Google account timezone. |
36 
37## Examples
38 
39```bash
40gws calendar +agenda
41gws calendar +agenda --today
42gws calendar +agenda --week --format table
43gws calendar +agenda --days 3 --calendar 'Work'
44gws calendar +agenda --today --timezone America/New_York
45```
46 
47## Tips
48 
49- Read-only — never modifies events.
50- Queries all calendars by default; use --calendar to filter.
51- Uses your Google account timezone by default; override with --timezone.
52 
53## See Also
54 
55- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
56- [gws-calendar](../gws-calendar/SKILL.md) — All manage calendars and events commands
57