Change appointment
Changes the date, time, service, staff member or notes of an existing appointment.
MCP tool planity_write → update_appointment
write Confirm
Returns the appointment after the change. Only the fields you pass change. It moves the booking of a real client, and the help article does not say whether Planity notifies them, so the agent reads the appointment back to check. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| appointment_id string required | string | Id from list_appointments. |
| start string | string | New date and start time, ISO 8601, in the salon's local time. |
| staff_id string | string | New staff member. |
| service_id string | string | New service. |
| notes string | string | New note. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "planity_write",
"arguments": {
"operation": "update_appointment",
"arguments": {
"appointment_id": "appointment_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"appointment_id": "a_9120",
"start": "2026-10-27T09:30:00",
"end": "2026-10-27T10:30:00",
"client": {
"client_id": "c_1042",
"name": "Léa Martin"
},
"service": "Coupe femme",
"staff": {
"staff_id": "st_01",
"name": "Amélie"
},
"status": "confirmed"
},
"isError": false
}