Back to Google Calendar

Connect Knoon AI with Google Calendar (Google) to automate AI workflows.

List availability for booking in a calendar.

googleCalendarListAvailability

BETA

Permissions

https://www.googleapis.com/auth/calendar.readonly

Optional permissions

There are no items to display.

Parameters

Name	Type	Description	Required
calendarId	file	ID of the calendar to search (e.g. "primary" or a specific calendar ID).	Yes
start	mustache	Window start in ISO 8601 (e.g. "2025-11-20T09:00:00+08:00" or "2025-11-20T09:00:00"). Offset (if present) is used as the reference timezone.	Yes
end	mustache	Window end in ISO 8601. Must be after start. Offset (if present) is used as the reference timezone.	Yes
durationMinutes	mustache	Duration (in minutes) to test whether a free range can fit, e.g. "30".	Yes

Returns

Name	Type	Description
start	string	Range start in RFC 3339/ISO 8601 format.
end	string	Range end in RFC 3339/ISO 8601 format.
availability	string	Availability label for the range (one of "free", "busy", "unavailable" when durationMinutes cannot fit).
durationMinutes	number	Requested duration (in minutes) used for fit evaluation.
dayOfWeekLocal	string	Day of week for the range start in the requested/local timezone (e.g. "Monday").
dayOfWeekUTC	string	Day of week for the range start in UTC (e.g. "Monday").