Check availability times
Open times on one date for an appointment type.
MCP tool acuity_scheduling_read → check_availability_times
read
Returns the open start times on one date for the appointment type, as ISO timestamps with offset, matching what clients see on your scheduler. To move an appointment to a time that overlaps its own slot, pass its ID in ignore_appointment_ids so the current slot counts as free.
Parameters
| Name | Type | Description |
|---|---|---|
| appointment_type_id integer required | integer | Appointment type ID from list_appointment_types. |
| date string required | string | Day to check, e.g. '2026-11-03'. |
| calendar_id integer | integer | Calendar ID from list_appointment_types or list_appointments. Without it, every calendar that offers the type is checked. |
| addon_ids integer[] | integer[] | Add-ons of this appointment type to include. |
| timezone string | string | Long-form timezone ID, e.g. 'America/New_York'. |
| ignore_appointment_ids integer[] | integer[] | Appointments to ignore, so their own slots show as open. Use when rescheduling. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "acuity_scheduling_read",
"arguments": {
"operation": "check_availability_times",
"arguments": {
"appointment_type_id": 1,
"date": "2026-11-03"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"times": [
{
"time": "2026-11-03T10:00:00-0500"
},
{
"time": "2026-11-03T11:00:00-0500"
},
{
"time": "2026-11-03T14:00:00-0500"
}
]
},
"isError": false
}