Gws Calendar Agenda
Pull a read-only Google Calendar agenda (today, week, or N days) from the terminal for planning and agent context.
Overview
gws-calendar-agenda is an agent skill for the Operate phase that shows read-only upcoming Google Calendar events via the gws CLI.
Install
npx skills add https://github.com/googleworkspace/cli --skill gws-calendar-agendaWhat is this skill?
- Read-only gws calendar +agenda across all calendars by default
- Filters: --today, --tomorrow, --week, --days, --calendar, --timezone (IANA)
- Table-friendly output via --format table for agent-readable summaries
- Requires gws CLI and gws-shared SKILL.md for auth and security rules
- CLI help: gws calendar +agenda --help (metadata v0.22.5)
- metadata version 0.22.5
- 7 documented CLI flags on +agenda
Adoption & trust: 26k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need your agent or terminal to show what is on your Google calendars without manual copy-paste or risky write access.
Who is it for?
Solo builders already on gws auth who want fast, scriptable calendar reads for daily planning and agent context.
Skip if: People who need to create or reschedule events (this skill is read-only) or teams not using the Google Workspace gws CLI stack.
When should I use this skill?
Google Calendar: show upcoming events across all calendars (gws calendar +agenda).
What do I get? / Deliverables
You get a filtered, timezone-correct agenda snapshot your agent can cite for planning, with no calendar mutations.
- Terminal or table-formatted agenda for today, tomorrow, week, or custom day range
Recommended Skills
Journey fit
Daily calendar visibility supports how solo builders run the business—Operate is the natural home even though the skill lives in a CLI integration pack. iterate fits ongoing scheduling checks and planning loops without modifying calendar data.
How it compares
Thin CLI integration over Google Calendar— not a full calendar MCP server or separate SaaS scheduling product.
Common Questions / FAQ
Who is gws-calendar-agenda for?
Indie builders and operators using the Google Workspace gws CLI with Claude Code, Cursor, or Codex who want read-only agenda pulls.
When should I use gws-calendar-agenda?
During Operate iterate loops for daily or weekly planning; also handy before Ship launch windows when you need a week view; anytime you want --today or --days summaries in the terminal.
Is gws-calendar-agenda safe to install?
It is read-only by design, but calendar data is sensitive—review the Security Audits panel on this Prism page, follow gws-shared auth rules, and avoid piping output into public logs.
Workflow Chain
Requires first: gws shared
SKILL.md
READMESKILL.md - Gws Calendar Agenda
# 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 ```bash 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 ```bash 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](../gws-shared/SKILL.md) — Global flags and auth - [gws-calendar](../gws-calendar/SKILL.md) — All manage calendars and events commands