mcp-cliniko
MCP Cliniko Server
Сервер протокола контекста модели (MCP), обеспечивающий интеграцию с API Cliniko для управления медицинской практикой.
Возможности
Инструменты (Действия)
Управление пациентами
list_patients- Поиск и список пациентовget_patient- Получение пациента по IDcreate_patient- Создание нового пациентаupdate_patient- Обновление данных пациентаdelete_patient- Архивация пациента
Управление записями на прием
list_appointments- Поиск и список записей на приемget_appointment- Получение записи на прием по IDcreate_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
Установка
Клонируйте репозиторий:
git clone https://github.com/yourusername/mcp-cliniko.git
cd mcp-clinikoУстановите зависимости:
npm installНастройте ваш API-ключ Cliniko:
cp .env.example .env
# Edit .env and add your Cliniko API keyСоберите проект:
npm run buildКонфигурация
Переменные окружения
CLINIKO_API_KEY- Ваш API-ключ Cliniko (обязательно)
Получение API-ключа Cliniko
Войдите в свою учетную запись Cliniko
Перейдите в Settings → Integrations → API Keys
Создайте новый API-ключ
Скопируйте ключ в ваш файл
.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 123patients://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 toolscancel_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
Scored across 27 tools
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.
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.
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.
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
Related MCP Connectors
Read splose patients, appointments, invoices, cases; book and cancel appointments, record payments.
Hosted MCP server for Cliniko — patients, appointments, availability, and invoices for AI agents.
Read Halaxy patients, appointments, slots and invoices; create patients, appointments and notes.
Search clients, appointments, intakes, notes and invoices in IntakeQ, and book or cancel visits.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- FlicenseNot gradedqualityCmaintenanceExposes 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.-
- AlicenseBqualityDmaintenanceProvides 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.272MIT