Cliniko MCP Server
A Model Context Protocol (MCP) server for integrating with the Cliniko practice management system.
Setup
-
Install Dependencies
pip install -r requirements.txt -
Configure API Key Create a
.envfile in the project root with your Cliniko API key:CLINIKO_API_KEY=your_actual_cliniko_api_key_hereTo get your API key:
- Log into your Cliniko account
- Go to Settings → Integrations → API Keys
- Create a new API key
-
Run the Server
python main.py
Project Structure
cliniko_mcp_server/
│
├── .env # API key configuration (create this file)
├── main.py # Server entry point
├── cliniko_client.py # Cliniko API client
├── requirements.txt # Python dependencies
│
├── tools/ # MCP Tools
│ ├── __init__.py
│ ├── patients.py # Patient management tools
│ └── appointments.py # Appointment management tools
│
└── resources/ # MCP Resources
├── __init__.py
└── index.py # Resource definitions
Available Tools
Patient Tools
list_patients- List/search all patientsget_patient- Get patient by IDcreate_patient- Create new patientupdate_patient- Update patient detailsdelete_patient- Delete (archive) a patient
Appointment Tools
list_appointments- List/search all appointmentsget_appointment- Get appointment by IDcreate_appointment- Create new appointmentupdate_appointment- Update appointment detailsdelete_appointment- Delete an appointment
Available Resources
patient://{id}- Get patient by IDpatients://list- List all patientsappointment://{id}- Get appointment by IDappointments://list- List all appointments
API Endpoints
The server connects to the Cliniko API at: https://api.au4.cliniko.com/v1
Authentication
Uses Basic Authentication with your Cliniko API key. The key is automatically encoded and included in all API requests.