# Cliniko MCP Server

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

## Setup

1. **Install Dependencies**
   ```bash
   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**
   ```bash
   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.