Cliniko MCP by usefulapi

Get the Cliniko account and subscription details for the authenticated API key. A good first call to sanity-check auth, shard, and User-Agent. GET /account.

Takes no parameters.

Search/list patients. Name/email filters use Cliniko 'contains' matching (q[]=field:~value). GET /patients.

Fetch a single patient by id. GET /patients/{id}.

List individual appointments, optionally filtered by patient/practitioner/business/type and a starts_at window (starts_from / starts_to: ISO 8601 with Z or an offset, or YYYY-MM-DD = 00:00 UTC; sent to Cliniko in UTC). GET /individual_appointments.

Fetch a single individual appointment by id. GET /individual_appointments/{id}.

List practitioners in the account. GET /practitioners.

List businesses (practice locations) in the account. GET /businesses.

List appointment types (service definitions). GET /appointment_types.

List billable products/items. GET /products.

List invoices, optionally filtered by patient. GET /invoices.

Fetch a single invoice by id. GET /invoices/{id}.

List treatment notes, optionally filtered by patient. NOTE: treatment notes are protected health information (PHI) — handle with care. Read-only. GET /treatment_notes.

Fetch a single treatment note by id. NOTE: treatment notes are protected health information (PHI). Read-only. GET /treatment_notes/{id}.

List bookable appointment slots for a business + practitioner + appointment type within a date range (from/to, yyyy-mm-dd, span <= 7 days). High-value booking-slot lookup. GET /businesses/{business_id}/practitioners/{practitioner_id}/appointment_types/{appointment_type_id}/available_times.

Get the single next bookable slot for a business + practitioner + appointment type (optionally from a date). GET /businesses/{business_id}/practitioners/{practitioner_id}/appointment_types/{appointment_type_id}/next_available_time.

WRITE — creates a REAL new patient record in the live Cliniko practice. Requires first_name + last_name. POST /patients.

WRITE — books a REAL new individual appointment in the live Cliniko practice. Requires patient_id, practitioner_id, business_id, appointment_type_id, and starts_at (ISO 8601 with Z or an offset; sent in UTC). ends_at defaults from the appointment type if omitted. To hold time without a patient (a room block, lunch, leave), use cliniko_create_unavailable_block instead. POST /individual_appointments.

List the practice's unavailable block types (e.g. Room Block, Lunch, Leave) with id, name, colour and default duration. Use the id as unavailable_block_type_id in cliniko_create_unavailable_block. GET /unavailable_block_types.

List unavailable blocks (diary time held without a patient: room blocks, lunch, leave), optionally filtered by business, practitioner, block type and a starts_at window (ISO 8601 with Z or an offset, or YYYY-MM-DD = 00:00 UTC). Archived blocks are excluded. GET /unavailable_blocks.

WRITE — holds REAL diary time in the live Cliniko practice without a patient: a room block, lunch, leave or meeting. No patient_id. Requires business_id, practitioner_id (the diary column to block), starts_at and ends_at (ISO 8601 with Z or an offset; sent in UTC). Set unavailable_block_type_id (from cliniko_list_unavailable_block_types, e.g. the Room Block type) and put the room or reason in notes. repeat_rule repeats the block. Undo with cliniko_archive_unavailable_block. POST /unavailable_blocks.

WRITE — archives (removes from the diary) one REAL unavailable block in the live Cliniko practice, e.g. to undo a block created by mistake. POST /unavailable_blocks/{id}/archive.