Google Calendar
GOOGLECALENDAR_FIND_FREE_SLOTS
Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range (defaults to the current day UTC if `time_min`/`time_max` are omitted). Returns busy intervals enriched with event details and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods.
Remote googlecalendar
Other tools also called GOOGLECALENDAR_FIND_FREE_SLOTS?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "string"
},
"default": [
"primary"
],
"description": "List of calendar identifiers to query for free/busy information. Each item must be a valid calendar identifier: 'primary' for the user's main calendar, a user/calendar email (e.g., [email protected]), or a calendar ID ending with a Google Calendar domain (e.g., [email protected]). Only calendars accessible to the authenticated account are allowed. All identifiers are validated; if any is invalid or not found, the action returns an error.\nExamples:\n \"primary\"\n \"[email protected]\"\n \"[email protected]\""
},
"time_max": {
"type": [
"string",
"null"
],
"default": null,
"description": "End datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats. If provided without an explicit timezone, it is interpreted in the specified `timezone`. Maximum span between time_min and time_max is approximately 90 days per Google Calendar freeBusy API limit.\nExamples:\n \"2024-12-06T18:00:00Z\"\n \"2024,12,06,18,00,00\"\n \"2024-12-06 18:00:00\""
},
"time_min": {
"type": [
"string",
"null"
],
"default": null,
"description": "Start datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats. If provided without an explicit timezone, it is interpreted in the specified `timezone`. Maximum span between time_min and time_max is approximately 90 days per Google Calendar freeBusy API limit.\nExamples:\n \"2024-12-06T13:00:00Z\"\n \"2024,12,06,13,00,00\"\n \"2024-12-06 13:00:00\""
},
"timezone": {
"type": "string",
"default": "UTC",
"description": "IANA timezone identifier (e.g., 'America/New_York', 'Europe/London'). Determines how naive `time_min`/`time_max` are interpreted and the timezone used in the response for `timeMin`, `timeMax`, busy periods, and calculated free slots.\nExamples:\n \"UTC\"\n \"America/New_York\"\n \"Europe/Berlin\""
},
"group_expansion_max": {
"type": "integer",
"default": 100,
"description": "Maximum calendar identifiers to return for a single group; exceeding this causes an error. Max allowed: 100."
},
"calendar_expansion_max": {
"type": "integer",
"default": 50,
"description": "Maximum calendars for which FreeBusy information is provided. Max allowed: 50."
}
}
}