Skip to main content
Glama

Healthie MCP by usefulapi

by io.usefulapi
OverviewDiscussionsAdmin

Server Details

Hosted MCP server for the Healthie EHR & telehealth API: patients, appointments, charting, tasks.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
80.1% over 54 days
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

A3.9/5.0

Scored across 16 tools

Disambiguation5/5

Each tool targets a distinct resource and action—create_note vs create_task, get_user vs list_patients, list_forms vs list_form_answer_groups—so there is little chance of selecting the wrong tool. Even the many list_* tools are clearly separated by domain.

Naming Consistency5/5

Tool names consistently follow a healthie_<verb>_<noun> pattern using snake_case, with verbs limited to create, get, list, and current. The naming is uniform and predictable across all 16 tools.

Tool Count4/5

At 16 tools, the server is slightly above the ideal 3–15 range, but the breadth of Healthie's domain—appointments, documents, forms, goals, metrics, messaging, patients, and tasks—justifies the count. It feels dense but not bloated.

Completeness3/5

The tool set is strongly read-oriented: most resources support list/get operations, but only notes and tasks can be created, with no update or delete lifecycle coverage. This leaves notable gaps for workflows like completing a task, editing a note, or creating an appointment.

Available Tools

16 tools
healthie_create_noteCreate a note / chat entry (WRITE — creates a record)
Destructive
Inspect

Creates a note/chat entry in Healthie (additive). Requires content (the note text); optionally attach it to a client (user_id) or mark it as an org chat. GraphQL: mutation createNote(input: createNoteInput).

ParametersJSON Schema
NameRequiredDescriptionDefault
contentYesThe note text.
user_idNoThe client/user the note is about.
org_chatNoTrue if created in the organization chat context.
healthie_create_taskCreate a task (WRITE — creates a record)
Destructive
Inspect

Creates a task in Healthie (additive). Requires content (the task text); optionally attach it to a client (user_id), set a due_date, priority, or created_by_id. GraphQL: mutation createTask(input: createTaskInput).

ParametersJSON Schema
NameRequiredDescriptionDefault
contentYesThe task text/description.
user_idNoThe client/user the task is about.
due_dateNoDue date (YYYY-MM-DD).
priorityNoPriority (integer).
created_by_idNoId of the user creating the task.
healthie_current_userCurrent user / account
Read-only
Inspect

Fetch the authenticated Healthie account (the provider/user that owns the API key). Good first call to verify auth. Read-only. GraphQL: query currentUser.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

healthie_get_appointmentGet an appointment
Read-only
Inspect

Fetch a single appointment by id. Read-only. GraphQL: query appointment(id).

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe appointment id.
healthie_get_organizationGet organization
Read-only
Inspect

Fetch the current organization / practice (name, NPI, contact, user counts). Read-only. GraphQL: query organization.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

healthie_get_userGet a user / patient
Read-only
Inspect

Fetch a single user (patient or provider) by id. Read-only. GraphQL: query user(id).

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe user id.
healthie_list_appointmentsList appointments
Read-only
Inspect

List appointments, optionally filtered by patient, provider, date range, time-filter or status. Read-only. GraphQL: query appointments(user_id, provider_id, filter, startDate, endDate, filter_by_appointment_status).

ParametersJSON Schema
NameRequiredDescriptionDefault
filterNoTime filter: "future" (default), "past", "ended", "didnt-occur".
endDateNoEnd date (YYYY-MM-DD) to bound results.
user_idNoFilter to appointments for this patient/client id.
startDateNoStart date (YYYY-MM-DD) to bound results.
provider_idNoFilter to appointments for this provider id.
filter_by_appointment_statusNoFilter by appointment status label.
healthie_list_appointment_typesList appointment types
Read-only
Inspect

List the practice's appointment types (services), optionally keyword-filtered. Read-only. GraphQL: query appointmentTypes(keywords, offset, page_size, should_paginate).

ParametersJSON Schema
NameRequiredDescriptionDefault
offsetNoPagination offset. Default 0.
keywordsNoFree-text search over appointment type names.
page_sizeNoResults per page. Default 25.
healthie_list_conversationsList conversations
Read-only
Inspect

List messaging conversations, optionally between the current user and a given user. Read-only. GraphQL: query conversations(user_id).

ParametersJSON Schema
NameRequiredDescriptionDefault
user_idNoGet conversations between the current user and this user id.
healthie_list_documentsList documents
Read-only
Inspect

List documents, optionally scoped to a patient (viewable_user_id) or by keyword. Read-only. GraphQL: query documents(viewable_user_id, keywords, offset, page_size, should_paginate).

ParametersJSON Schema
NameRequiredDescriptionDefault
offsetNoPagination offset. Default 0.
keywordsNoFree-text search over document names.
page_sizeNoResults per page. Default 25.
viewable_user_idNoPatient id whose documents to list.
healthie_list_form_answer_groupsList completed forms / charting notes
Read-only
Inspect

List completed form submissions (charting notes / filled intake forms), optionally scoped to a patient or a form template. Read-only. GraphQL: query formAnswerGroups(user_id, custom_module_form_id, should_paginate, offset).

ParametersJSON Schema
NameRequiredDescriptionDefault
offsetNoPagination offset. Default 0.
user_idNoFilter to submissions for this patient id.
custom_module_form_idNoFilter to submissions of this form template id.
healthie_list_formsList charting / intake form templates
Read-only
Inspect

List custom module form templates (charting notes, intake forms), optionally by keyword or category. Read-only. GraphQL: query customModuleForms(keywords, category, offset, page_size, should_paginate).

ParametersJSON Schema
NameRequiredDescriptionDefault
offsetNoPagination offset. Default 0.
categoryNoFilter by form category.
keywordsNoFree-text search over form names.
page_sizeNoResults per page. Default 25.
healthie_list_goalsList goals
Read-only
Inspect

List goals, optionally scoped to a patient. Read-only. GraphQL: query goals(user_id, offset, per_page).

ParametersJSON Schema
NameRequiredDescriptionDefault
offsetNoPagination offset. Default 0.
user_idNoFilter to goals for this patient id.
per_pageNoResults per page. Default 25.
healthie_list_metric_entriesList metric entries
Read-only
Inspect

List tracked metric entries (weight, blood pressure, etc.), optionally scoped to a client or a category. Read-only. GraphQL: query entries(client_id, category, offset, page_size).

ParametersJSON Schema
NameRequiredDescriptionDefault
offsetNoPagination offset. Default 0.
categoryNoEntry category, e.g. "MetricEntry", "Weight".
client_idNoFilter to entries for this client id.
page_sizeNoResults per page (max 500). Default 25.
healthie_list_patientsList patients / clients
Read-only
Inspect

List patients/clients, optionally filtered by keyword search or active status. Read-only. GraphQL: query users(keywords, offset, page_size, should_paginate, active_status).

ParametersJSON Schema
NameRequiredDescriptionDefault
offsetNoPagination offset. Default 0.
keywordsNoFree-text search over name/email.
page_sizeNoResults per page (max 100). Default 25.
active_statusNoFilter by status: "active" or "archived".
healthie_list_tasksList tasks
Read-only
Inspect

List tasks, optionally scoped to a client or filtered by completion status. Read-only. GraphQL: query tasks(client_id, completed_status, offset, per_page).

ParametersJSON Schema
NameRequiredDescriptionDefault
offsetNoPagination offset. Default 0.
per_pageNoResults per page. Default 25.
client_idNoFilter to tasks about this client id.
completed_statusNoCompletion filter, e.g. "complete" or "incomplete".

Tool Schema Changelog

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

  1. 16 tool updates
    • Changedhealthie_create_note1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_create_task1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_current_user1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_get_appointment1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_get_organization1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_get_user1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_appointment_types1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_appointments1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_conversations1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_documents1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_form_answer_groups1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_forms1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_goals1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_metric_entries1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_patients1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedhealthie_list_tasks1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. 16 tool updates
    • First observedhealthie_create_note
    • First observedhealthie_create_task
    • First observedhealthie_current_user
    • First observedhealthie_get_appointment
    • First observedhealthie_get_organization
    • First observedhealthie_get_user
    • First observedhealthie_list_appointment_types
    • First observedhealthie_list_appointments
    • First observedhealthie_list_conversations
    • First observedhealthie_list_documents
    • First observedhealthie_list_form_answer_groups
    • First observedhealthie_list_forms
    • First observedhealthie_list_goals
    • First observedhealthie_list_metric_entries
    • First observedhealthie_list_patients
    • First observedhealthie_list_tasks

Related MCP Connectors

Related MCP Servers

Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources