Block staff time
Blocks a staff member's agenda for a period, once or repeating, so no client can book online in it.
MCP tool planity_write → block_time
write
Returns the block with an id. Planity says no client can book online in the blocked time. It does not move or delete appointments already in the period: list_appointments shows them. A block reaches no one and is undone with remove_block, so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| staff_id string required | string | Id from list_staff. |
| start string required | string | Start of the block, ISO 8601, in the salon's local time. |
| end string required | string | End of the block, same day as start. |
| repeat string | string | How the block repeats: none (default), daily or weekly. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "planity_write",
"arguments": {
"operation": "block_time",
"arguments": {
"staff_id": "st_01",
"start": "2026-10-26T09:00:00",
"end": "2026-10-26T13:00:00",
"repeat": "weekly"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"block_id": "b_330",
"staff": {
"staff_id": "st_01",
"name": "Amélie"
},
"start": "2026-10-26T09:00:00",
"end": "2026-10-26T13:00:00",
"repeat": "weekly",
"online_booking_blocked": true
},
"isError": false
}