calendar_* — Google Calendar

The Google Calendar tool namespace — listing calendars and events, creating/updating/deleting events, and free/busy lookups — with the canonical-name note and the calendar_id default.

The calendar_* family is Google Calendar via Leif — list, read, create, update, delete events, and check free/busy. Most tools default calendar_id="primary", so you only pass a calendar ID when working a non-primary calendar.

Calendars & events

calendar_list_calendars

calendar_list_calendars()

All accessible calendars — the source of calendar_id values for the rest.

calendar_get_events

calendar_get_events(calendar_id="primary", query=None, time_min=None,
                    time_max=None, max_results=10)

Filter by free-text query and/or a time_min/time_max window (ISO-8601).

calendar_get_free_busy

calendar_get_free_busy(calendar_ids, time_min, time_max)

Busy blocks across one or more calendars — the tool for “when is everyone free.” calendar_ids is a list; time_min/time_max are required.

Mutating events

calendar_create_event

calendar_create_event(summary, start_time, end_time, calendar_id="primary",
                      description=None, location=None, attendees=None,
                      timezone="UTC")

Required: summary, start_time, end_time. attendees is a list of email addresses. Set timezone to the real one — leaving it UTC on a local event is the classic off-by-hours bug.

calendar_update_event

calendar_update_event(event_id, calendar_id="primary", summary=None,
                      start_time=None, end_time=None, description=None,
                      location=None, timezone="UTC")

Only event_id is required; pass just the fields you’re changing.

calendar_delete_event

calendar_delete_event(event_id, calendar_id="primary")
  • Memory & State — commitments and the daily review, which sit alongside calendar work
  • Tools — catalog overview and routing rules