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

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 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.