mcpField
C
Cliniko MCP by usefulapi

Cliniko MCP by usefulapi

Remote
usefulapi.ioHealth0Updated today

About Cliniko MCP by usefulapi

A hosted MCP server for practices using Cliniko, enabling AI agents to access patient, appointment, availability, invoice, and treatment-note data. It also supports creating patients and appointments, and requires a Cliniko API key.

Key features

  1. 01List and retrieve patient records
  2. 02View appointments and availability
  3. 03Access invoices and treatment notes
  4. 04Create patients and appointments
  5. 05Browse practitioners and practice records

Use cases

  1. 01Review a patient's Cliniko record
  2. 02Check appointment availability
  3. 03Create a patient or book an appointment
  4. 04Look up invoices and treatment notes

MCP support

Exposes Cliniko account, patient, appointment, practitioner, invoice, treatment-note, and availability tools to MCP clients, including tools to create patients and appointments. The hosted server connects using the user's Cliniko API key.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://cliniko.usefulapi.io/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

17

This tool takes no parameters.

Details

From the project README

Cliniko MCP by usefulapi

Manage your Cliniko practice — patients, appointments, availability, invoices and treatment notes — from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Cliniko API key.

Live endpoint: https://cliniko.usefulapi.io/mcp · Homepage: https://usefulapi.io/cliniko

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://cliniko.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http cliniko https://cliniko.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
{
  "mcpServers": {
    "cliniko": {
      "url": "https://cliniko.usefulapi.io/mcp"
    }
  }
}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Cliniko credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/cliniko/

On first connect you'll paste your Cliniko API key. It's validated, stored per-user, and scoped to you.

Tools

ToolTypeWhat it does
cliniko_get_accountreadGet account details
cliniko_list_patientsreadList patients
cliniko_get_patientreadGet a patient
cliniko_list_appointmentsreadList appointments
cliniko_get_appointmentreadGet an appointment
cliniko_list_practitionersreadList practitioners
cliniko_list_businessesreadList businesses
cliniko_list_appointment_typesreadList appointment types
cliniko_list_productsreadList products
cliniko_list_invoicesreadList invoices
cliniko_get_invoicereadGet an invoice
cliniko_list_treatment_notesreadList treatment notes
cliniko_get_treatment_notereadGet a treatment note
cliniko_list_available_timesreadList available times
cliniko_next_available_timereadNext available time
cliniko_create_patientwriteCreate a patient
cliniko_create_appointmentwriteCreate an appointment
cliniko_usage_statusmetaUsage status (free-tier meter)
cliniko_request_featuremetaRequest a missing feature
cliniko_upgrademetaUpgrade to Pro (unlimited*)
cliniko_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with cliniko_upgrade (it returns a Stripe Checkout link). Cancel any time with cliniko_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running cliniko_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.