CharmHealth — Claude Code MCP server: what it does, how to install
Connects AI assistants to CharmHealth EHR for patient search, clinical encounters, and appointment scheduling. Requires Python 3.13+ and a HIPAA-compliant environment.
no license updated 2026-10-29
Open on GitHubWhat CharmHealth 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.
What it helps with
- 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 for the agent
- 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
How to install CharmHealth
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about CharmHealth
How to install CharmHealth for Claude Code?
Clone the repository using git clone https://github.com/CharmHealth/charm-mcp-server.git, enter the directory with cd charm-mcp-server, and prepare dependencies with uv sync. Start the server with uv run --directory src mcp_server.py.
What does the CharmHealth MCP server do?
It connects your MCP client to CharmHealth EHR, allowing assistants to query patient records, manage appointments, log diagnoses, and dispatch messages.
What compliance conditions are required to run this server?
Live clinical data requires a signed BAA with the model vendor and zero data retention. For local stdio runs, you must set CHARMHEALTH_ALLOW_SERVER_CREDENTIALS=1 in your .env configuration.