Check availability dates
Days in one month that have openings for an appointment type.
MCP tool acuity_scheduling_read → check_availability_dates
read
Returns the dates in the month that have at least one open time for the appointment type, matching what clients see on your scheduler. Pass add-ons that belong to the type, because they change the openings. Call check_availability_times for the actual times on one of these dates.
Parameters
| Name | Type | Description |
|---|---|---|
| appointment_type_id integer required | integer | Appointment type ID from list_appointment_types. |
| month string required | string | Month to check, e.g. '2026-11'. |
| 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'. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "acuity_scheduling_read",
"arguments": {
"operation": "check_availability_dates",
"arguments": {
"appointment_type_id": 1,
"month": "2026-11"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"dates": [
"2026-11-03",
"2026-11-04",
"2026-11-05",
"2026-11-09"
]
},
"isError": false
}