Cliniko MCP by usefulapi
Hosted MCP server connecting AI assistants to Cliniko patients, appointments and invoices
- Pricing
- Freemium
- Platforms
- API, Web, vscode
- Runs
- Remotely
- Version
- 1.41.4
- Listing updated
- 1 day ago
Similar MCP servers
About Cliniko MCP by usefulapi
Cliniko MCP by usefulapi is a freemium MCP server for health and science. It runs as a hosted remote server, so there is nothing to install locally.
The Cliniko connector is a hosted remote MCP endpoint that lets an AI client read and, with approval, write data in a Cliniko practice account. Setup is done by adding a single URL to a client such as Claude, ChatGPT, Cursor or VS Code, then signing in with a Cliniko API key on the login page.
The server exposes 25 tools. Most are read-only and cover patients, appointments, bookable slots, practitioners, locations, invoices and treatment notes. Four tools can create patients, book appointments, create unavailable diary blocks and archive those blocks. The README notes that clients should ask for confirmation before running write tools.
The product's own documentation says it must not be used with protected health information and that no HIPAA Business Associate Agreement is offered. It is an independent service by usefulapi and is not affiliated with Cliniko. The free tier allows 50 tool calls a month, with paid Pro and Pro+ plans for higher limits.
Install
Run in a terminal
claude mcp add --transport http cliniko https://cliniko.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://cliniko.usefulapi.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"cliniko": {
"url": "https://cliniko.usefulapi.io/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"cliniko": {
"type": "http",
"url": "https://cliniko.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cliniko": {
"serverUrl": "https://cliniko.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"cliniko": {
"type": "http",
"url": "https://cliniko.usefulapi.io/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (21)
Read directly from the server.
- cliniko_get_account
- 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.
- cliniko_list_patients
- Search/list patients. Name/email filters use Cliniko 'contains' matching (q[]=field:~value). GET /patients.
- cliniko_get_patient
- Fetch a single patient by id. GET /patients/{id}.
- cliniko_list_appointments
- 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.
- cliniko_get_appointment
- Fetch a single individual appointment by id. GET /individual_appointments/{id}.
- cliniko_list_practitioners
- List practitioners in the account. GET /practitioners.
- cliniko_list_businesses
- List businesses (practice locations) in the account. GET /businesses.
- cliniko_list_appointment_types
- List appointment types (service definitions). GET /appointment_types.
- cliniko_list_products
- List billable products/items. GET /products.
- cliniko_list_invoices
- List invoices, optionally filtered by patient. GET /invoices.
- cliniko_get_invoice
- Fetch a single invoice by id. GET /invoices/{id}.
- cliniko_list_treatment_notes
- List treatment notes, optionally filtered by patient. NOTE: treatment notes are protected health information (PHI) — handle with care. Read-only. GET /treatment_notes.
- cliniko_get_treatment_note
- Fetch a single treatment note by id. NOTE: treatment notes are protected health information (PHI). Read-only. GET /treatment_notes/{id}.
- cliniko_list_available_times
- 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.
- cliniko_next_available_time
- 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.
- cliniko_create_patient
- WRITE — creates a REAL new patient record in the live Cliniko practice. Requires first_name + last_name. POST /patients.
- cliniko_create_appointment
- 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
- cliniko_list_unavailable_block_types
- 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.
- cliniko_list_unavailable_blocks
- 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.
- cliniko_create_unavailable_block
- 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 note
- cliniko_archive_unavailable_block
- 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.
What it does
- Hosted remote endpoint
- Connects over Streamable HTTP with OAuth sign-in, so there is nothing to install locally.
- Read-only appointment lookup
- Lists appointments and finds the next bookable slot for a practitioner and appointment type.
- Patient and invoice access
- Searches patients and lists or fetches invoices, optionally filtered by patient.
- Limited write actions
- Can create patients and appointments and add or archive unavailable diary blocks.
- Usage metering
- Tools report current plan usage and let the user upgrade, change or cancel a subscription.
Good for
- Check tomorrow's appointments and the practitioners they are with
- Find the next open slot for a service
- Look up a patient's invoices and payment details
- Add a new patient record from a chat request
- Block a room or lunch break in the practice diary
Pricing
Freemium, from $9 a month
Free plan with 50 calls/month; Pro from $9/mo or $90/yr; Pro+ from $39/mo.
Prices change. Check usefulapi.io before you buy.
Cliniko MCP by usefulapi FAQ
Is this an official Cliniko product?
No. The site states that usefulapi is an independent service and is not affiliated with or endorsed by Cliniko.
Can I use it with patient health data?
No. The documentation says not to use the server with protected health information and that no HIPAA Business Associate Agreements are signed.
What does it cost?
The Free plan includes 50 tool calls per month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls.
How do I connect it?
Add the server URL as a custom connector or remote MCP server in your client, then sign in with your Cliniko API key on the login page.
Is Cliniko MCP by usefulapi free?
Cliniko MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.
How do I add Cliniko MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http cliniko https://cliniko.usefulapi.io/mcp
What are the best alternatives to Cliniko MCP by usefulapi?
The closest alternatives to Cliniko MCP by usefulapi are Tooluniverse, Oya Browser, BasalFit, Ebi Ols and Clinicaltables.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

