Block off time
Block a time range on a calendar so no new client can book it.
MCP tool acuity_scheduling_write → block_off_time
write Confirm
Adds a time block on one calendar, with optional notes. It stops new bookings in that range, but an appointment already there stays on the calendar, and group classes are not affected. Returns the block ID and a readable description of the range. Remove a block in Acuity under Availability, Edit Availability/Limits, Blocked Time. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| calendar_id integer required | integer | Calendar to block. |
| start string required | string | Start of the block, e.g. '2026-11-05T09:00:00-0500'. |
| end string required | string | End of the block, e.g. '2026-11-05T17:00:00-0500'. |
| notes string | string | Note for yourself on the block. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "acuity_scheduling_write",
"arguments": {
"operation": "block_off_time",
"arguments": {
"calendar_id": 1,
"start": "2026-11-05T09:00:00-0500",
"end": "2026-11-05T17:00:00-0500"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"block_id": 7790112,
"notes": "Out sick",
"description": "Thursday 5 November 2026 9:00am - 5:00pm"
},
"isError": false
}