# Healthie MCP by usefulapi

> Healthie MCP by usefulapi is an MCP server. Hosted MCP server for the Healthie EHR & telehealth API: patients, appointments, charting, tasks. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/healthie/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/healthie
- **MCP Registry name:** io.usefulapi/healthie
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http healthie https://healthie.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://healthie.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "healthie": {
      "url": "https://healthie.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "healthie": {
      "type": "http",
      "url": "https://healthie.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "healthie": {
      "serverUrl": "https://healthie.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "healthie": {
      "type": "http",
      "url": "https://healthie.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `healthie_current_user`: Fetch the authenticated Healthie account (the provider/user that owns the API key). Good first call to verify auth. Read-only. GraphQL: query currentUser.
- `healthie_get_organization`: Fetch the current organization / practice (name, NPI, contact, user counts). Read-only. GraphQL: query organization.
- `healthie_list_patients`: List patients/clients, optionally filtered by keyword search or active status. Read-only. GraphQL: query users(keywords, offset, page_size, should_paginate, active_status).
- `healthie_get_user`: Fetch a single user (patient or provider) by id. Read-only. GraphQL: query user(id).
- `healthie_list_appointments`: 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).
- `healthie_get_appointment`: Fetch a single appointment by id. Read-only. GraphQL: query appointment(id).
- `healthie_list_appointment_types`: List the practice's appointment types (services), optionally keyword-filtered. Read-only. GraphQL: query appointmentTypes(keywords, offset, page_size, should_paginate).
- `healthie_list_forms`: 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).
- `healthie_list_form_answer_groups`: 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).
- `healthie_list_documents`: 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).
- `healthie_list_tasks`: List tasks, optionally scoped to a client or filtered by completion status. Read-only. GraphQL: query tasks(client_id, completed_status, offset, per_page).
- `healthie_list_goals`: List goals, optionally scoped to a patient. Read-only. GraphQL: query goals(user_id, offset, per_page).
- `healthie_list_metric_entries`: 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).
- `healthie_list_conversations`: List messaging conversations, optionally between the current user and a given user. Read-only. GraphQL: query conversations(user_id).
- `healthie_create_task`: 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).
- `healthie_create_note`: 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).

## FAQ

### How do I add Healthie MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http healthie https://healthie.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/healthie-mcp-by-usefulapi
