# View Your Google Calendar Agenda

Upcoming events can be difficult to review across multiple calendars. This skill displays a read-only agenda with date, calendar, and timezone filters.

## Install

```bash
npx skillstore add googleworkspace/gws-calendar-agenda
```

## Metadata

- Status: approved
- Slug: googleworkspace-gws-calendar-agenda
- Version: 0.23.0
- Author version: 0.23.0
- Skillstore revision: r2
- Version status: valid
- Tree hash: 8aee07c25a8ad8d72ec2b2498d3be45a548087a2779538cf795a87d719dd7e07
- Author: googleworkspace
- GitHub username: googleworkspace
- License: MIT
- Repository: https://github.com/googleworkspace/cli/tree/main/skills/gws-calendar-agenda/
- Ref: 286d37c9c189ddd1aafd3548415fb031d1df79d5
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 80
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/googleworkspace-gws-calendar-agenda
- Manifest: https://skillstore.pages.dev/api/skills/googleworkspace-gws-calendar-agenda/manifest

## Capabilities

- Shows upcoming events across all connected Google calendars.
- Filters events for today, tomorrow, the current week, or a selected number of days.
- Filters the agenda by a calendar name or identifier.
- Displays dates using the Google account timezone or a specified IANA timezone.
- Supports table output through the gws command format option.

## Use Cases

- Review Daily Meetings: Display today's events across every connected calendar before starting work.
- Plan the Work Week: Review this week's schedule to identify conflicts and available time.
- Coordinate Across Timezones: View upcoming events in a selected IANA timezone when coordinating distributed teams.

## Prompt Templates

### Show My Agenda

```
Show my upcoming Google Calendar events across all calendars.
```

### Review Today

```
Show today's events across all calendars using my Google account timezone.
```

### Filter a Work Calendar

```
Show events from my Work calendar for the next three days.
```

### Prepare a Timezone Agenda

```
Show this week's events in America/New_York and format the results as a table.
```

## Limitations

- Requires the gws CLI and an authenticated Google account.
- Only reads agenda data and does not create, edit, or delete events.
- Calendar access remains limited by the authenticated account permissions.
- The skill does not document free-text event search or attendee filtering.

## Best Practices

- Use a specific date range to keep the agenda concise.
- Select a calendar when only one schedule is relevant.
- Specify an IANA timezone when reviewing events for another region.

## Anti Patterns

- Do not expect the skill to modify or cancel calendar events.
- Do not request calendars unavailable to the authenticated Google account.
- Do not use ambiguous timezone abbreviations when an IANA timezone is available.

## Security Audit

- Audited at: 2026-08-05T10:45:23.79\+00:00
- Summary: All 13 static findings are false positives caused by Markdown backticks, code fences, and relative documentation links. The skill documents read-only Google Calendar commands and shows no prompt injection, unsafe path handling, or malicious intent.

## Stats

- Views: 93
- Downloads: 8
- Favorites: 0
- Popularity score: 0