check-calendar
Reads iCal (.ics) feeds and lists the events in a date range, in local time (Pacific), including events a feed gives in another time zone. Recurring events appear once per occurrence. Cancelled events are left out. A range is at most 92 days.
Calendars
Each calendar is one environment variable, CALENDAR_ICS_<NAME>, holding
its feed address. The name used in calendar and shown on each event is
<NAME> lowercased with _ turned into -: CALENDAR_ICS_GRANDKIDS_SCHOOL
is grandkids-school. Which calendars exist is set by the user; a call
that finds no events, or names an unknown calendar, lists them.
The feed addresses are secrets and are never shown.
Each event
- Time range, or "all day" (with the last day if it spans several).
- Calendar name in brackets, then the title.
- Location and organizer when the feed has them.
Your response:accepted / declined / tentative / not answered — only on events where the user is an attendee.- The description, cut at 500 characters with a line giving its full length.
If one calendar fails to load, the result names it and still shows the others.
Examples
{"thought": "what's on this week", "tool": "check-calendar"}
{"thought": "is there a school holiday in November", "tool": "check-calendar", "calendar": "grandkids-school", "start": "2026-11-01", "days": 30}