Skip to content
MCP server

Cliniko MCP by usefulapi

Hosted MCP server connecting AI assistants to Cliniko patients, appointments and invoices

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://cliniko.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cliniko": {
      "url": "https://cliniko.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers