Cliniko MCP Server

A Model Context Protocol (MCP) server for integrating with the Cliniko practice management system.

Setup

1. Install Dependencies

   pip install -r requirements.txt

2. Configure API Key Create a .env file in the project root with your Cliniko API key:

   CLINIKO_API_KEY=your_actual_cliniko_api_key_here

   To get your API key:

   • Log into your Cliniko account

   • Go to Settings → Integrations → API Keys

   • Create a new API key

3. Run the Server

   python main.py

Project Structure

Available Tools

Patient Tools

• list_patients - List/search all patients

• get_patient - Get patient by ID

• create_patient - Create new patient

• update_patient - Update patient details

• delete_patient - Delete (archive) a patient

Appointment Tools

• list_appointments - List/search all appointments

• get_appointment - Get appointment by ID

• create_appointment - Create new appointment

• update_appointment - Update appointment details

• delete_appointment - Delete an appointment

Available Resources

• patient://{id} - Get patient by ID

• patients://list - List all patients

• appointment://{id} - Get appointment by ID

• appointments://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.