Skip to content

Google Calendar Agenda

Lets the agent list your upcoming Google Calendar events across all calendars.

Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

This skill teaches an AI agent to run the gws command-line tool to read your upcoming Google Calendar events, covering today, tomorrow, this week, or a set number of days, across all your calendars or a named one. It is read-only and does not create, change, or delete events. It uses your Google account's timezone unless you specify another.

Great for

  • People who want a quick summary of their day or week without opening Google Calendar
  • Developers or assistant users who already use the gws CLI and want agents to check schedules

Skip it if

  • Creating, moving, or cancelling meetings, since this skill only reads events (use the broader gws-calendar skill instead)
  • Users without a Google account or without gws installed and authenticated, since the skill cannot run

Try asking

  • “What's on my calendar today?”
  • “Show me my agenda for this week in table format.”
  • “What meetings do I have in the next 3 days on my Work calendar?”
  • “List tomorrow's events in New York time.”
Step-by-step guide: how to use Google Calendar AgendaInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    gws-calendar-agenda.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip gws-calendar-agenda.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip gws-calendar-agenda.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run gws generate-skills first if the shared gws-shared skill file is missing.
  • Use --calendar with a calendar name or ID to narrow results and reduce noise.
  • Specify --timezone when you are travelling so times display correctly.

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.