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

Related MCP server: MCP Cliniko Server

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.