Skip to main content
Glama
mcp-cliniko

mcp-cliniko

MCP Cliniko Server

Сервер протокола контекста модели (MCP), обеспечивающий интеграцию с API Cliniko для управления медицинской практикой.

Возможности

Инструменты (Действия)

  • Управление пациентами

    • list_patients - Поиск и список пациентов

    • get_patient - Получение пациента по ID

    • create_patient - Создание нового пациента

    • update_patient - Обновление данных пациента

    • delete_patient - Архивация пациента

  • Управление записями на прием

    • list_appointments - Поиск и список записей на прием

    • get_appointment - Получение записи на прием по ID

    • create_appointment - Бронирование новой записи

    • update_appointment - Изменение записи

    • cancel_appointment - Отмена записи

    • delete_appointment - Удаление записи

    • get_available_times - Получение доступного времени специалиста

  • Управление счетами

    • list_invoices - Список и фильтрация счетов

    • get_invoice - Получение деталей счета

    • create_invoice - Создание нового счета

    • update_invoice - Обновление статуса или деталей счета

    • delete_invoice - Удаление черновика счета

  • Позиции счета

    • list_invoice_items - Список позиций в счете

    • add_invoice_item - Добавление позиции в счет

    • update_invoice_item - Изменение позиции счета

    • delete_invoice_item - Удаление позиции из счета

  • Обработка платежей

    • list_payments - Список платежей с фильтрацией

    • create_payment - Регистрация платежа

    • delete_payment - Удаление записи о платеже

  • Продукты и услуги

    • list_products - Список оплачиваемых продуктов/услуг

    • get_product - Получение деталей продукта

    • create_product - Создание нового продукта/услуги

  • Настройка налогов

    • list_taxes - Список доступных налоговых ставок

    • get_tax - Получение деталей налога

  • Сложные рабочие процессы

    • create_invoice_from_appointments - Генерация счетов на основе записей на прием

    • bulk_invoice_generation - Массовое создание счетов за период

    • list_patient_cases - Список случаев пациента

    • list_invoices_for_case - Получение счетов для случая

  • Вспомогательные инструменты

    • list_practitioners - Список всех специалистов

    • list_appointment_types - Список типов записей на прием

    • list_businesses - Список организаций

  • Тестовые данные

    • generate_test_data - Генерация синтетических данных австралийской системы здравоохранения

    • cleanup_test_data - Удаление тестовых пациентов

Ресурсы (Доступ к данным)

  • patient://{id} - Данные отдельного пациента

  • patients://list - Все пациенты

  • appointment://{id} - Отдельная запись на прием

  • appointments://list - Все записи на прием

  • appointments://today - Записи на сегодня

  • practitioners://list - Все специалисты

  • businesses://list - Все организации

  • appointment-types://list - Все типы записей на прием

  • openapi://spec - Спецификация OpenAPI API Cliniko (формат YAML)

Related MCP server: Cliniko MCP Server

Установка

  1. Клонируйте репозиторий:

git clone https://github.com/yourusername/mcp-cliniko.git
cd mcp-cliniko
  1. Установите зависимости:

npm install
  1. Настройте ваш API-ключ Cliniko:

cp .env.example .env
# Edit .env and add your Cliniko API key
  1. Соберите проект:

npm run build

Конфигурация

Переменные окружения

  • CLINIKO_API_KEY - Ваш API-ключ Cliniko (обязательно)

Получение API-ключа Cliniko

  1. Войдите в свою учетную запись Cliniko

  2. Перейдите в Settings → Integrations → API Keys

  3. Создайте новый API-ключ

  4. Скопируйте ключ в ваш файл .env

Использование

Режим разработки

npm run dev

Промышленный режим

npm start

Тестирование с помощью MCP Inspector

npm run inspect

Интеграция с Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cliniko": {
      "command": "node",
      "args": ["/path/to/mcp-cliniko/dist/index.js"],
      "env": {
        "CLINIKO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Примеры

Использование инструментов

Список пациентов:

{
  "tool": "list_patients",
  "arguments": {
    "q": "Smith",
    "per_page": 10
  }
}

Создание пациента:

{
  "tool": "create_patient",
  "arguments": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone_number": "0412345678",
    "date_of_birth": "1980-01-15",
    "medicare_number": "1234567890"
  }
}

Бронирование записи на прием:

{
  "tool": "create_appointment",
  "arguments": {
    "starts_at": "2024-01-20T10:00:00Z",
    "patient_id": 123,
    "practitioner_id": 456,
    "appointment_type_id": 789,
    "business_id": 101
  }
}

Генерация тестовых данных:

{
  "tool": "generate_test_data",
  "arguments": {
    "num_patients": 5,
    "num_appointments": 10,
    "days_ahead": 7
  }
}

Использование ресурсов

Ресурсы предоставляют доступ к данным Cliniko только для чтения:

  • patient://123 - Получить пациента с ID 123

  • patients://list - Список всех пациентов

  • appointments://today - Получить записи на сегодня

Ограничения API

API Cliniko имеет ограничение в 200 запросов в минуту. Сервер не реализует ограничение частоты запросов внутри себя, поэтому учитывайте этот лимит при выполнении массовых операций.

Обработка ошибок

Сервер использует стандартные соглашения об ошибках HTTP:

  • 400 - Неверный запрос

  • 401 - Неавторизован (проверьте API-ключ)

  • 404 - Ресурс не найден

  • 429 - Превышен лимит запросов

  • 500 - Внутренняя ошибка сервера

Разработка

Структура проекта

mcp-cliniko/
├── src/
│   ├── index.ts              # Main server
│   ├── cliniko-client.ts     # API client
│   ├── types.ts              # TypeScript types
│   ├── tools/                # MCP tools
│   │   ├── patients.ts
│   │   ├── appointments.ts
│   │   └── synthetic-data.ts
│   └── resources/            # MCP resources
│       └── index.ts
├── dist/                     # Compiled JavaScript
├── package.json
├── tsconfig.json
└── .env

Сборка

npm run build

Проверка типов

npx tsc --noEmit

Лицензия

MIT

Поддержка

Документация по API Cliniko доступна по адресу: https://docs.api.cliniko.com/

Документация по MCP доступна по адресу: https://modelcontextprotocol.io/

Available Tools

27 tools
cancel_appointmentC

Cancel an appointment

Inputs: appointment_id (required), cancellation_reason.

cleanup_comprehensive_test_dataC

Clean up all test data with granular control and dry-run option

Inputs: delete_patients, delete_appointments, delete_invoices, delete_products, +3 more.

cleanup_test_dataA

Delete all test patients (patients with emails ending in @gmail.com, @outlook.com, etc)

Inputs: no named parameters.

create_appointmentC

Create a new appointment

Inputs: starts_at (required), practitioner_id (required), appointment_type_id (required), business_id (required), +2 more.

create_patientC

Create a new patient

Inputs: first_name (required), last_name (required), title, preferred_name, +12 more.

delete_appointmentC

Delete an appointment completely

Inputs: appointment_id (required).

delete_patientA

Delete (archive) a patient

Inputs: patient_id (required).

demo_invoice_generationA

Demo: Generate test patients and appointments, then show how to create invoices. NOTE: Cliniko API is READ-ONLY for invoices - they must be created via the web interface.

Inputs: target_date, num_patients, num_appointments, clear_existing, +1 more.

display_invoices_for_dateB

Display all existing invoices for a specific date (READ-ONLY). Invoices must be created manually in Cliniko.

Inputs: target_date (required), display_format.

generate_comprehensive_test_dataB

Generate comprehensive synthetic test data across all Cliniko categories

Inputs: num_patients, num_contacts, num_relationships, num_appointments, +11 more.

generate_test_dataB

Generate synthetic test data for Cliniko (Australian healthcare data)

Inputs: num_patients, num_appointments, days_ahead.

get_appointmentC

Get a specific appointment by ID

Inputs: appointment_id (required).

get_appointment_invoicesA

Get invoices for a specific appointment (READ-ONLY)

Inputs: appointment_id (required).

get_available_timesC

Get available appointment times for a practitioner

Inputs: business_id (required), practitioner_id (required), from (required), to (required).

get_invoiceA

Get details of a specific invoice (READ-ONLY)

Inputs: invoice_id (required).

get_patientC

Get a specific patient by ID

Inputs: patient_id (required).

get_patient_invoicesA

Get invoices for a specific patient (READ-ONLY)

Inputs: patient_id (required).

how_to_create_invoicesB

Get instructions on how to create invoices in Cliniko (manual process)

Inputs: no named parameters.

list_appointmentsC

List or search for appointments

Inputs: patient_id, practitioner_id, business_id, starts_at, +4 more.

list_appointment_typesB

List all appointment types

Inputs: page, per_page.

list_businessesB

List all businesses

Inputs: no named parameters.

list_invoice_itemsB

List items in an invoice (READ-ONLY)

Inputs: invoice_id (required).

list_invoicesB

List invoices with filtering options (READ-ONLY - invoices must be created in Cliniko web interface)

Inputs: page, per_page, patient_id, practitioner_id, +3 more.

list_patientsC

List or search for patients

Inputs: q, page, per_page.

list_practitionersC

List all practitioners

Inputs: page, per_page.

update_appointmentC

Update an existing appointment

Inputs: appointment_id (required), starts_at, notes, patient_id.

update_patientC

Update an existing patient

Inputs: patient_id (required), first_name, last_name, title, +13 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 27 tools

    Disambiguation4/5

    Most tools target distinct resources (patients, appointments, invoices) with clear purposes. However, cleanup_test_data and cleanup_comprehensive_test_data are very similar, and demo_invoice_generation overlaps with how_to_create_invoices in providing guidance.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_patient, list_appointments, delete_patient). No mixing of styles or ambiguous verbs.

    Tool Count3/5

    27 tools is slightly high for a healthcare practice server. Multiple test data generation and cleanup tools add redundancy, and several invoice tools are read-only due to API limitations, reducing effective utility. A more streamlined set (around 15-20) would be better.

    Completeness4/5

    CRUD operations are covered for patients and appointments, along with listings and searches. Invoice operations are read-only but acknowledged. Missing features like appointment notes or patient tags are minor given the domain focus.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Athena Health's API for comprehensive healthcare practice management. Supports appointment scheduling, provider and department management, patient search, and available slot discovery through natural language.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables integration with the Cliniko practice management system through MCP tools and resources. Supports patient management, appointment scheduling, and practice data access through natural language interactions.
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Exposes tools from the Ecuro Light API for managing clinical appointments, patient records, and clinic availability. It enables users to perform healthcare management tasks such as scheduling, patient search, and report generation through MCP-compatible clients.
      -
    • A
      license
      B
      quality
      D
      maintenance
      Provides comprehensive integration with the Cliniko API for healthcare practice management, including patient, appointment, and invoice administration. It enables tools for complex clinical workflows and direct access to practice resources through the Model Context Protocol.
      27
      2
      MIT