Google Calendar

Get current time

Return the current wall-clock time. Use this when reasoning about elapsed time (e.g. current minute of a live match, time until a deadline) or about what day it is — don't guess the time or the date. By default `now_iso` and `local_date` are in the user's own timezone (near midnight the UTC date is a day ahead of the user's local date). Pass `timezone` (an IANA name like 'Europe/Berlin') only to override that, e.g. to read the time in another location.

List calendars

List every calendar the user can see, with id, summary, primary flag, access role, and time zone. Use during onboarding to discover the family calendar, kids' activity calendars, and any shared work calendars.

Get event

Get a single event by ID. Returns full event details including summary, start, end, location, description, attendees, and status. Use when you have an event ID from a previous call.

List events

List events in a time window for a single calendar. Returns summary, start, end, location, and attendees for each event. Always pass an explicit calendar_id — use list_calendars first if you do not have one. For multi-calendar searches, call once per calendar. To find a specific kind of event across a long window (e.g. 'when was my last haircut', 'all my dentist appointments'), pass `query` — a free-text search over the event title, description, location, and attendees — instead of pulling the whole window and scanning. It returns only the matching events, so it stays small even across years.

Create event

Create a new event on a specified calendar. Pass start and end as RFC3339 strings with explicit timezone offsets. By default no notifications are sent to attendees. Confirm destructive or noticeable scheduling with the user first.

Update event

Update an existing calendar event. Only the fields you provide are changed; omitted fields are left as-is. Use to add carpool details to descriptions, update attendees, change times, etc.

Delete event

Delete a calendar event. This is irreversible. Confirm with the user before deleting.

Respond to event

Respond to a calendar invitation (RSVP). Sets the authenticated user's attendance status on the event.

Find free time

Find busy windows across one or more calendars in a date range. Returns the busy intervals per calendar — invert them to find free time. Use for 'when am I free' questions and for fitting new events into existing schedules.