CharmHealth MCP Server

An MCP server for CharmHealth EHR that allows LLMs and MCP clients to interact with patient records, encounters, and practice information.

Critical HIPAA Notice

[!CAUTION] This server can access, transmit, and surface protected health information (PHI). Use it only with:

• HIPAA-compliant LLM services covered by a signed BAA and configured with no training and zero data retention
• HIPAA-compliant MCP clients, or clients operated entirely within your HIPAA compliance program

If you are using this with actual patient data (non-sandbox data), do not connect non-HIPAA consumer LLM endpoints or clients. You are responsible for enforcing access controls, audit logging, encryption in transit/at rest, and data retention policies for your deployment.

Features

The server provides 16 comprehensive tools for complete EHR functionality:

• Encounter Management: Complete SOAP note workflow and clinical findings
• Patient Search & Records: Advanced patient search with demographics, location, and medical criteria
• Patient Management: Complete demographic and administrative data handling
• Medical History: Comprehensive patient clinical overview and history review
• Drug Management: Unified medications, supplements, and prescribing with safety checks
• Allergy Management: Critical allergy documentation with safety alerts
• Diagnosis Management: Problem list and diagnosis tracking
• Clinical Notes: Quick clinical observations and provider communications
• Recalls & Follow-ups: Preventive care reminders and appointment scheduling
• Vital Signs: Complete vital signs recording and trend monitoring
• File Management: Patient photos, documents, and PHR invitations
• Laboratory Management: Lab results tracking and detailed reporting
• Practice Setup: Facilities, providers, and vital sign templates
• Appointment Management: Complete appointment lifecycle with scheduling and rescheduling
• Task Management: Complete task lifecycle
• Patient Messaging: Secure portal, SMS, and WhatsApp messaging with conversation threads
• Fax: Send faxes and track delivery status

Quick Start

1. Clone and install dependencies:

   git clone https://github.com/CharmHealth/charm-mcp-server.git
   cd charm-mcp-server
   uv sync
   

2. Configure environment:

   cp .env.example .env
   # Edit .env with your CharmHealth API credentials
   

3. Run the server:

   uv run --directory src mcp_server.py
   

4. Configure your HIPAA-compliant MCP client (e.g., an enterprise/HIPAA-compliant deployment of your chosen client) to connect to the server.

Prerequisites