Get appointment
Reads one appointment with its notes, extra services and the client's contact details.
MCP tool planity_read → get_appointment
read
Returns the fields the appointment window shows: client, date and start time, service, staff member, extra services, notes and title. It does not return payment tickets; the cash register is not covered.
Parameters
| Name | Type | Description |
|---|---|---|
| appointment_id string required | string | Id from list_appointments. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "planity_read",
"arguments": {
"operation": "get_appointment",
"arguments": {
"appointment_id": "appointment_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"appointment_id": "a_9120",
"start": "2026-10-26T09:30:00",
"end": "2026-10-26T10:30:00",
"client": {
"client_id": "c_1042",
"name": "Léa Martin",
"phone": "+33 6 00 00 00 00"
},
"service": "Coupe femme",
"extra_services": [],
"staff": {
"staff_id": "st_01",
"name": "Amélie"
},
"status": "confirmed",
"notes": "Wants to keep the length."
},
"isError": false
}