MCP server

Halaxy MCP by usefulapi

io.usefulapi/halaxy

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read Halaxy patients, appointments, slots and invoices; create patients, appointments and notes.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

35

Token cost

About 12,389 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http halaxy https://halaxy.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.halaxy]
url = "https://halaxy.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"halaxy":{"httpUrl":"https://halaxy.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"halaxy":{"url":"https://halaxy.usefulapi.io/mcp"}}}

VS Code

{"servers":{"halaxy":{"type":"http","url":"https://halaxy.usefulapi.io/mcp"}}}

Antigravity

agy mcp add halaxy https://halaxy.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"halaxy","server_url":"https://halaxy.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"halaxy","server_url":"https://halaxy.usefulapi.io/mcp"}

Tools

• halaxy_create_appointment ~518 tokens
  Writes to the live Halaxy account. Books an appointment for a patient with a practitioner at a clinic (the practitioner role). Halaxy also creates the invoice, clinical note and reminder. Use halaxy_find_available_appointments for free times. By default a double booking is refused (HTTP 409, nothing
• halaxy_create_clinical_note ~276 tokens
  Writes to the live Halaxy account. Adds a clinical note to a patient's record as a DRAFT (preliminary); the practitioner reviews and publishes it in Halaxy. The author is a PractitionerRole (practitioner at a clinic). Only HTML text is supported. POST /main/DocumentReference.
• halaxy_create_patient ~534 tokens
  Writes to the live Halaxy account. Creates a new patient record (always a new one: search with halaxy_list_patients first to avoid a duplicate). Pass managing_organization (the practice group id, e.g. PG-12345, from halaxy_list_organizations) if Halaxy asks for it. POST /main/Patient.
• halaxy_find_available_appointments ~531 tokens
  Find free appointment times between start and end for a given duration, respecting each practitioner's online booking preferences (buffer time, lead time, advance booking limit). Narrow it with practitioner, practitioner_role or organization. GET /main/Appointment/$find.
• halaxy_get_appointment ~118 tokens
  Fetch an appointment with its participants and statuses (HEALTH DATA) by id. GET /main/Appointment/{id}.
• halaxy_get_coverage ~110 tokens
  Fetch a patient's coverage (claim details) record by id. GET /main/Coverage/{id}.
• halaxy_get_fee ~111 tokens
  Fetch a fee (ChargeItemDefinition) by id. GET /main/ChargeItemDefinition/{id}.
• halaxy_get_healthcare_service ~111 tokens
  Fetch an appointment type by id. GET /main/HealthcareService/{id}.
• halaxy_get_invoice ~99 tokens
  Fetch an invoice by id. GET /main/Invoice/{id}.
• halaxy_get_invoice_line ~104 tokens
  Fetch an invoice line by id. GET /main/InvoiceLine/{id}.
• halaxy_get_organization ~116 tokens
  Fetch a practice group, clinic, funder or external practice by id. GET /main/Organization/{id}.
• halaxy_get_patient ~105 tokens
  Fetch a patient record (HEALTH DATA) by id. GET /main/Patient/{id}.
• halaxy_get_payment_transaction ~112 tokens
  Fetch a payment transaction by id. GET /main/PaymentTransaction/{id}.
• halaxy_get_practitioner ~110 tokens
  Fetch a practitioner or administrator by id. GET /main/Practitioner/{id}.
• halaxy_get_practitioner_role ~116 tokens
  Fetch a practitioner role at a clinic location by id. GET /main/PractitionerRole/{id}.
• halaxy_get_referral ~104 tokens
  Fetch a referral (HEALTH DATA) by id. GET /main/Referral/{id}.
• halaxy_get_referral_definition ~112 tokens
  Fetch a referral template by id. GET /main/ReferralDefinition/{id}.
• halaxy_get_schedule ~104 tokens
  Fetch a practitioner schedule by id. GET /main/Schedule/{id}.
• halaxy_get_slot ~97 tokens
  Fetch a time slot by id. GET /main/Slot/{id}.
• halaxy_list_appointments ~840 tokens
  List or search appointments (HEALTH DATA: names the patient). Filters combine with AND. Paged: pass next_page as page. GET /main/Appointment.
• halaxy_list_coverage ~700 tokens
  List or search patients' health fund membership and claim details (HEALTH DATA). Filters combine with AND. Paged: pass next_page as page. GET /main/Coverage.
• halaxy_list_fees ~501 tokens
  List or search fees (ChargeItemDefinition): the services and products a practice charges for. Filters combine with AND. Paged: pass next_page as page. GET /main/ChargeItemDefinition.
• halaxy_list_healthcare_services ~349 tokens
  List or search appointment types used by the practice group, clinics and practitioners. Filters combine with AND. Paged: pass next_page as page. GET /main/HealthcareService.
• halaxy_list_invoice_lines ~733 tokens
  List or search invoice lines: single fees on invoices. Filters combine with AND. Paged: pass next_page as page. GET /main/InvoiceLine.
• halaxy_list_invoices ~799 tokens
  List or search invoices of the practice group. Filters combine with AND. Paged: pass next_page as page. GET /main/Invoice.
• halaxy_list_organizations ~424 tokens
  List or search the practice group, its clinic locations, funders and external practices (practice group ids look like PG-12345). Filters combine with AND. Paged: pass next_page as page. GET /main/Organization.
• halaxy_list_patients ~783 tokens
  List or search patient records (demographics and contact details; HEALTH DATA). Filters combine with AND. Paged: pass next_page as page. GET /main/Patient.
• halaxy_list_payment_transactions ~352 tokens
  List or search payment transactions recorded on invoices. Filters combine with AND. Paged: pass next_page as page. GET /main/PaymentTransaction.
• halaxy_list_practitioner_roles ~566 tokens
  List or search practitioner roles: a practitioner's association with one clinic location (the id used when booking and for clinical notes). Filters combine with AND. Paged: pass next_page as page. GET /main/PractitionerRole.
• halaxy_list_practitioners ~519 tokens
  List or search practitioners and administrators of the practice group (ids look like PR-12345). Filters combine with AND. Paged: pass next_page as page. GET /main/Practitioner.
• halaxy_list_referral_definitions ~332 tokens
  List or search referral templates with preset properties. Filters combine with AND. Paged: pass next_page as page. GET /main/ReferralDefinition.
• halaxy_list_referrals ~566 tokens
  List or search referrals from one healthcare provider to another (HEALTH DATA). Filters combine with AND. Paged: pass next_page as page. GET /main/Referral.
• halaxy_list_schedules ~413 tokens
  List or search schedules: containers of bookable time slots per practitioner. Filters combine with AND. Paged: pass next_page as page. GET /main/Schedule.
• halaxy_list_slots ~720 tokens
  List or search time slots of practitioner schedules (free or busy). Filters combine with AND. Paged: pass next_page as page. GET /main/Slot.
• halaxy_update_appointment_status ~304 tokens
  Writes to the live Halaxy account. Sets the patient's status on an appointment (shown in the Halaxy calendar), for example arrived, attended, confirmed or cancelled. "cancelled (no charge)" also sets the invoice to $0. For a group appointment pass patient_id to say whose status changes. PATCH /main/

Browse

• Booking and scheduling
• To-do lists
• Payments
• Invoicing and accounting

Related MCP servers

• splose MCP by usefulapi
  Read splose patients, appointments, invoices, cases; book and cancel appointments, record payments.
• Semble MCP by usefulapi
  Read Semble patients, bookings, invoices and products; create patients and tasks, label patients.
• Elation Health MCP by usefulapi
  Read Elation Health patients, appointments, problems, allergies, medications, notes and vitals.
• NexHealth MCP by usefulapi
  Read and write NexHealth appointments, patients, providers and locations.
• Cliniko MCP by usefulapi
  Hosted MCP server for Cliniko — patients, appointments, availability, and invoices for AI agents.
• DrChrono MCP by usefulapi
  Read and write DrChrono patients, appointments, offices and clinical notes.
• Akute Health MCP by usefulapi
  Read Akute Health patients, appointments, tasks, notes, medications, allergies and observations.
• Acuity Scheduling MCP by usefulapi
  Read appointments, types, calendars and availability; create, cancel or reschedule bookings.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/halaxy.svg)](https://aptlynx.net/servers/io.usefulapi/halaxy)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents