Healthie MCP server. Hosted MCP server for the Healthie EHR & telehealth API: patients, appointments, charting, tasks.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"healthie": {
"url": "https://healthie.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
healthie_current_user | read | Current user Fetch the authenticated Healthie account behind the API key — a quick way to confirm the connection works and see which provider or user you are acting as. |
healthie_get_organization | read | Get organization Return the current organization or practice, including its name, NPI, contact details, tax id and total user count. |
healthie_list_patients | read | List patients List patients and clients in the practice, optionally narrowed by a keyword search over name and email or by active/archived status, with pagination. |
healthie_get_user | read | Get user Fetch a single user — patient or provider — by id, returning their name, contact details, date of birth, timezone and account status. |
healthie_list_appointments | read | List appointments List appointments, optionally filtered by patient, provider, date range, a time filter (future, past, ended, didn't-occur) or appointment status. |
healthie_get_appointment | read | Get appointment Fetch one appointment by id with its full detail — timing, location, contact type, provider, attendees and notes. |
healthie_list_appointment_types | read | List appointment types List the practice's bookable appointment types (services), with length, group and waitlist flags and client-facing display names. |
healthie_list_forms | read | List forms List custom module form templates such as charting notes and intake forms, optionally filtered by keyword or category. |
healthie_list_form_answer_groups | read | List form answer groups List completed form submissions — filled charting notes and intake forms — optionally scoped to a specific patient or form template. |
healthie_list_documents | read | List documents List documents, optionally scoped to a patient or searched by keyword, returning names, content types and expiring download URLs. |
healthie_list_tasks | read | List tasks List tasks, optionally scoped to a client or filtered by completion status, with due dates, priority and the client each task concerns. |
healthie_list_goals | read | List goals List care goals, optionally scoped to a patient, including description, start and due dates, repeat cadence and completion state. |
healthie_list_metric_entries | read | List metric entries List tracked metric entries such as weight or blood pressure, optionally scoped to a client or a metric category, with the recorded values. |
healthie_list_conversations | read | List conversations List secure messaging conversations, optionally between the current user and a given user, with participants and the latest message preview. |
healthie_create_task | write | Create task Create a task in Healthie from its text, optionally attaching it to a client and setting a due date, priority and the creating user. |
healthie_create_note | write | Create note Create a note or chat entry in Healthie from its text, optionally attaching it to a client or marking it as an organization chat. |
healthie_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
healthie_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Healthie tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Pro | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.