Get Free Slots
calendars_get_slotsRetrieve available free slots for a calendar within a specified date range, with optional filtering by timezone or user.
Instructions
Get Free Slots Get free slots for a calendar between a date range. Optionally a consumer can also request free slots in a particular timezone and also for a particular user. [GET /calendars/{calendarId}/free-slots] Scopes: calendars.readonly.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"calendarId": "<calendarId>",
"startDate": "<startDate>",
"endDate": "<endDate>"
},
"name": "calendars_get_slots"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| userId | No | The user for whom the free slots are returned | |
| endDate | Yes | End Date (**⚠️ Important:** Date range cannot be more than 31 days) | |
| userIds | No | The users for whom the free slots are returned | |
| timezone | No | The timezone in which the free slots are returned | |
| startDate | Yes | Start Date (**⚠️ Important:** Date range cannot be more than 31 days) | |
| calendarId | Yes | Calendar Id |