# CharmHealth

Connects AI assistants to CharmHealth EHR for patient search, clinical encounters, and appointment scheduling. Requires Python 3.13+ and a HIPAA-compliant environment.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: charmhealth
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/charmhealth/charm-mcp-server
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/charmhealth

## What it does

This server links language models with the CharmHealth EHR platform through the Model Context Protocol. It exposes 16 operational tools for practice workflows. Agents can look up patient cards, create SOAP clinical notes, verify medication safety against recorded allergies, and schedule visits. It also handles lab results, task tracking, faxes, and patient messaging via SMS or WhatsApp.

The codebase targets Python 3.13 or newer and runs via `uv` or Docker. It supports two transport options: standard input/output for local desktop clients and HTTP for networked setups. Connecting requires OAuth 2.0 parameters from CharmHealth, including an API key, client secret, and refresh token.

Without valid API credentials, the server fails immediately. Real patient records require strict compliance: you must have a signed BAA with zero data retention from the model vendor.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- search patient profiles by medical criteria and demographics
- record SOAP clinical encounter notes and observations
- track prescription safety checks and documented allergies
- schedule appointments and send preventive care reminders
- monitor laboratory findings and vital sign trends

## Example prompts
- Look up medical history and recorded allergies for patient Smith
- Draft a SOAP note for today's clinical encounter
- Check delivery status for the lab result fax

## Similar
- [healthcare-engineer](https://affpapa.org/en/nevibecode/agents/healthcare-engineer.md) — subagent · ★ 2858 repo stars
- [healthcare-emr-patterns](https://affpapa.org/en/nevibecode/skills/healthcare-emr-patterns.md) — skill · 6200 installs
- [healthcare-expert](https://affpapa.org/en/nevibecode/skills/healthcare-expert.md) — skill · 443 installs
- [hipaa-compliance](https://affpapa.org/en/nevibecode/skills/affaan-m-hipaa-compliance.md) — skill · 6200 installs
- [healthcare-admin](https://affpapa.org/en/nevibecode/agents/healthcare-admin.md) — subagent · ★ 6505 repo stars
- [VLayer](https://affpapa.org/en/nevibecode/mcp/vlayer.md) — MCP server · 1871 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
