An MCP server for CharmHealth EHR that allows LLMs and MCP clients to interact with patient recor...
10K+
An MCP server for CharmHealth EHR that allows LLMs and MCP clients to interact with patient records, encounters, and practice information.
| Attribute | Details |
|---|---|
| Docker Image | mcp/charmhealth-mcp-server |
| Author | CharmHealth |
| Repository | https://github.com/CharmHealth/charm-mcp-server |
| Attribute | Details |
|---|---|
| Dockerfile | https://github.com/CharmHealth/charm-mcp-server/blob/dae9f695b9ba82026959574d58db7e941703f026/Dockerfile |
| Commit | dae9f695b9ba82026959574d58db7e941703f026 |
| Docker Image built by | Docker Inc. |
| Docker Scout Health Score | |
| Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/charmhealth-mcp-server --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| Licence | MIT License |
| Tools provided by this Server | Short Description |
|---|---|
findPatients | Find patients. |
getPracticeInfo | Get practice information. |
manageAppointments | Manage appointments. |
manageEncounter | Manage encounters. |
manageFax | Send faxes and check fax delivery status. |
manageMessages | Manage patient and provider messaging across SMS, WhatsApp, and secure messaging channels. |
managePatient | Manage patients. |
managePatientAllergies | Manage patient allergies. |
managePatientDiagnoses | Manage patient diagnoses. |
managePatientDrugs | Manage patient drugs and supplements. |
managePatientFiles | Manage patient files and documents. |
managePatientLabs | Manage patient laboratory results. |
managePatientNotes | Manage patient notes. |
managePatientRecalls | Manage patient recalls. |
managePatientVitals | Manage patient vitals and vital signs. |
manageTasks | Manage CharmHealth tasks. |
reviewPatientHistory | Review patient history. |
findPatientsFind patients.
Find patients quickly using natural search terms or specific criteria. Handles everything from "find John Smith" to complex searches like "elderly diabetes patients in California". Essential first step for any patient-related task. Quick searches: Use search_type="name" with query="John Smith" for basic name searches Phone lookups: Use search_type="phone" with query="555-1234" (handles any format) Medical record: Use search_type="record_id" with query="MR123456"Complex searches: Use search_type="advanced" with multiple criteria:
Always returns patient_id needed for other tools. Start here before any patient operations.
When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values.
| Parameters | Type | Description |
|---|---|---|
age_max | string optional | |
age_min | string optional | |
blood_group | string optional | |
category_id | string optional | |
city | string optional | |
country | string optional | |
created_after | string optional | |
created_before | string optional | |
facility_id | string optional | |
gender | string optional | |
has_phr_account | string optional | |
language | string optional | |
limit | string optional | |
marital_status | string optional | |
modified_after | string optional | |
modified_before | string optional | |
page | string optional | |
postal_code | string optional | |
query | string optional | |
search_type | string optional | |
sort_by | string optional | |
sort_order | string optional | |
state | string optional | |
status | string optional |
getPracticeInfoGet practice information.
Get essential practice information needed for other operations - available facilities, providers, vital signs templates, etc. Use this to understand practice setup and get IDs for other tools. - "facilities": List all practice locations with IDs needed for scheduling - "providers": List all providers with IDs needed for appointments and encounters - "vitals": Available vital sign templates for documentation - "overview": Summary of practice setup with key counts and recent activity - "templates": List all available SOAP templates (id, name, type) for the practice - "template_details": Full template schema (widgets + entries) for given template_ids (comma-separated)When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values.
| Parameters | Type | Description |
|---|---|---|
info_type | string optional | |
template_ids | string optional |
manageAppointmentsManage appointments.
Complete appointment lifecycle management - schedule new appointments, reschedule existing ones, cancel appointments, and list appointments with flexible filtering. Handles the full appointment workflow. Actions: - "schedule": Create new appointment (requires patient_id, provider_id, facility_id, appointment_date, appointment_time). Check the provider's availability with manageAppointments(action='list') and provider_id, and across all facilities for the provider before suggesting a time. - "reschedule": Change existing appointment time (requires appointment_id + new scheduling details) - "cancel": Cancel appointment (requires appointment_id + cancel_reason) - "list": Show appointments with filtering (requires start_date, end_date_range, facility_ids; optionally filter by status/provider/mode)Time format: Use 12-hour format like "09:30 AM" or "02:15 PM" For recurring: Set repetition to "Weekly" or "Daily" and provide frequency + end_date For double booking: Use provider_double_booking="allow" or resource_double_booking="allow" to override checks For cancellation: Use delete_type "Current" for single appointment or "Entire" for recurring series
List filters (applied after fetching all appointments in the date range):
When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values.
| Parameters | Type | Description |
|---|---|---|
action | string | |
appointment_date | string optional | |
appointment_id | string optional | |
appointment_time | string optional | |
cancel_reason | string optional | |
consent_forms | string optional | |
delete_type | string optional | |
duration_minutes | string optional | |
end_date | string optional | |
end_date_range | string optional | |
facility_id | string optional | |
facility_ids | string optional | |
frequency | string optional | |
limit | string optional | |
member_ids | string optional | |
message_to_patient | string optional | |
mode | string optional | |
mode_filter | string optional | |
patient_id | string optional | |
provider_double_booking | string optional | |
provider_filter | string optional | |
provider_id | string optional | |
questionnaire | string optional | |
reason | string optional | |
receipt_id | string optional | |
repetition | string optional | |
resource_double_booking | string optional | |
resource_id | string optional | |
start_date | string optional | |
status | string optional | |
status_filter | string optional | |
status_ids | string optional | |
visit_type_id | string optional | |
weekly_days | string optional |
manageEncounterManage encounters.
Complete encounter workflow - create, review, and sign encounters with comprehensive clinical documentation. Essential for clinical workflow from initial documentation through final signature. Actions: - "list": List encounters for a patient (requires patient_id; optionally filter by filter_by, start_date, end_date, per_page, page) - "create": Create new encounter and document clinical findings (default) - "review": Display complete encounter details for review before signing - "sign": Electronically sign encounter after review and confirmation - "unlock": Unlock a previously signed encounter to allow modificationsFor creating encounters (two paths):
For reviewing encounters:
For signing encounters:
For unlocking encounters:
For updating encounters with template data:
Recommended workflow:
When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values.
| Parameters | Type | Description |
|---|---|---|
patient_id | string | |
action | string optional | |
appointment_id | string optional | |
chief_complaint | string optional | |
encounter_date | string optional | |
encounter_id | string optional | |
encounter_mode | string optional | |
end_date | string optional | |
entries | string optional | |
facility_id | string optional | |
filter_by | string optional | |
page | string optional | |
per_page | string optional | |
provider_id | string optional | |
reason | string optional | |
start_date | string optional | |
template_ids | string optional | |
visit_type_id | string optional |
manageFaxSend faxes and check fax delivery status.
Fax clinical documents (referrals, records, prior auth forms) to providers, facilities, pharmacies, and insurance companies. Check delivery status of sent faxes. Actions: - "send": Fax a document (requires recipient_fax_number, recipient_name, document_content_base64). document_content_base64 must be a base64-encoded PDF. Optionally include subject, remarks, and reference for the cover page. facility_id determines which facility's fax credentials and return number are used.Common fax use cases:
| Parameters | Type | Description |
|---|---|---|
action | string | |
document_content_base64 | string optional | |
facility_id | string optional | |
fax_id | string optional | |
recipient_fax_number | string optional | |
recipient_name | string optional | |
reference | string optional | |
remarks | string optional | |
subject | string optional |
manageMessagesManage patient and provider messaging across SMS, WhatsApp, and secure messaging channels.
Send messages to patients, read inbox messages, and retrieve conversation threads. Supports SMS (Twilio/Telnyx), WhatsApp Business, and secure portal messaging. Use this for patient communication, follow-ups, appointment confirmations, and responding to patient inquiries. Actions: - "send": Send a message to a patient (requires patient_id, content, and facility_id). Channel options: - "sms": Send via text message (patient must have TEXT_NOTIFY_ENABLED) - "whatsapp": Send via WhatsApp (patient must be opted in) - "secure": Send via secure portal message (requires subject) - "auto": Automatically select best available channel (default) facility_id is required for all channels. Use getPracticeInfo() to look up facility IDs. For WhatsApp templates, provide template_name and placeholder values. For secure messages to providers, use recipient_member_ids."list": Show recent secure portal messages from inbox. Filter by section: "FROM_PATIENTS" (inbox) or "TO_PATIENTS" (sent). Use facility_id to filter by facility. Note: SMS and WhatsApp conversations are not available via list — use action='get_thread' with a patient_id to retrieve those.
"get_thread": Get full conversation history with a specific patient (requires patient_id). Filter by thread_channel to see only SMS, WhatsApp, secure, or all channels.
Before sending clinical content, confirm with the provider. Routine messages (appointment reminders, general notifications) can be sent directly.
| Parameters | Type | Description |
|---|---|---|
action | string | |
channel | string optional | |
content | string optional | |
facility_id | string optional | |
message_type | string optional | |
page | string optional | |
page_size | string optional | |
patient_id | string optional | |
recipient_member_ids | string optional | |
section | string optional | |
subject | string optional | |
template_body_placeholders | string optional | |
template_header_placeholders | string optional | |
template_name | string optional | |
thread_channel | string optional |
managePatientManage patients.
Complete patient management with comprehensive demographic, social, and administrative data. Handles patient creation, updates, status changes, and complex relationships. Supports all CharmHealth patient data fields for complete EHR functionality. Actions: - "create": Add new patient (requires first_name, last_name, gender, date_of_birth OR age, facility_ids) - "update": Modify existing patient (requires patient_id + fields to change). - "activate": Reactivate deactivated patient (requires patient_id only) - "deactivate": Deactivate patient (requires patient_id only)Update Modes:
Demographics: Supports comprehensive patient information including social history, family data Addresses: If any address field provided, country is required (defaults to US) Facilities: Pass as list of facility IDs like "facility_123,facility_456". Categories: Pass as list like [{"category_id": "category_123"}]
Complex Relationships:
When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values.
| Parameters | Type | Description |
|---|---|---|
action | string | |
address_line1 | string optional | |
address_line2 | string optional | |
age | string optional | |
area | string optional | |
birth_order | string optional | |
blood_group | string optional | |
caregivers | string optional | |
categories | string optional | Categories: Pass as list like [{"category_id": "category_123"}] |
cause_of_death | string optional | |
city | string optional | |
country | string optional | |
county_code | string optional | |
custom_field_1 | string optional | |
custom_field_2 | string optional | |
custom_field_3 | string optional | |
custom_field_4 | string optional | |
custom_field_5 | string optional | |
date_of_birth | string optional | |
deceased | string optional | |
district | string optional | |
dod | string optional | |
duplicate_check | string optional | |
email | string optional | |
email_notification | string optional | |
emergency_contact_name | string optional | |
emergency_contact_phone | string optional | |
emergency_extn | string optional | |
employment_status | string optional | |
ethnicity | string optional | |
facility_ids | string optional | |
first_name | string optional | |
gender | string optional | |
gender_identity | string optional | |
guarantor | string optional | |
home_phone | string optional | |
id_qualifiers | string optional | |
introduction | string optional | |
is_multiple_birth | string optional | |
language | string optional | |
last_name | string optional | |
linked_patient_id | string optional | |
maiden_name | string optional | |
marital_status | string optional | |
middle_name | string optional | |
mother_first_name | string optional | |
mother_last_name | string optional | |
nick_name | string optional | |
patient_id | string optional | |
payment_end_date | string optional | |
payment_source | string optional | |
payment_start_date | string optional | |
phone | string optional | |
post_box | string optional | |
preferred_communication | string optional | |
primary_phone | string optional | |
race | string optional | |
record_id | string optional | |
rep_first_name | string optional | |
rep_last_name | string optional | |
send_phr_invite | string optional | |
sexual_orientation | string optional | |
smoking_status | string optional | |
source_name | string optional | |
source_value | string optional | |
state | string optional | |
suffix | string optional | |
text_notification | string optional | |
update_specific_details | string optional | |
voice_notification | string optional | |
work_phone | string optional | |
work_phone_extn | string optional | |
zip_code | string optional |
managePatientAllergiesManage patient allergies.
Critical allergy management with safety alerts - document patient allergies, update allergy information, and maintain allergy safety checks. Essential for safe prescribing and clinical decision-making. Actions: - "add": Document new allergy (requires allergen, allergy_type, severity, reactions, allergy_date) - "list": Show all patient allergies (optionally filter by severity/type) - "update": Modify existing allergy (requires record_id, allergen, allergy_type, severity, allergy_status — use action='list' first to get current values, then pass all required fields with your changes) - "delete": Remove allergy record (requires record_id)Safety critical: Always check allergies before prescribing medications. Common allergens: "Penicillin", "Latex", "Shellfish", "Nuts", "Contrast dye" Severity levels: "Mild", "Moderate", "Severe" Allergy types: "Medication", "Drug Substance", "Environmental", "Food", "Plant", "Animal", "Latex" Status values: "Active", "Inactive"
List filters:
When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values.
| Parameters | Type | Description |
|---|---|---|
action | string | |
patient_id | string | |
allergen | string optional | |
allergy_date | string optional | |
allergy_status | string optional | |
allergy_type | string optional | |
comments | string optional | |
limit | string optional | |
reactions | string optional | |
record_id | string optional | |
severity | string optional | |
severity_filter | string optional | |
type_filter | string optional |
managePatientDiagnosesManage patient diagnoses.
Complete diagnosis management for patient problem lists - add new diagnoses, update existing conditions, and maintain accurate medical problem lists. Essential for clinical reasoning and care planning. Actions: - "add": Add new diagnosis (requires diagnosis_name, diagnosis_code, code_type) - "list": Show all patient diagnoses (optionally filter by status, code type, and/or date range) - "update": Modify existing diagnosis (requires record_id + fields to change) - "delete": Remove diagnosis (requires record_id). Ask the user if they are sure they want to delete the diagnosis before proceeding.Code types: "ICD10", "SNOMED" Status options: "Active", "Inactive", "Resolved" List filters:
When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values.
| Parameters | Type | Description |
|---|---|---|
action | string | |
patient_id | string | |
code_type | string optional | |
code_type_filter | string optional | |
comments | string optional | |
diagnosis_code | string optional | |
diagnosis_name | string optional | |
diagnosis_order | string optional | |
diagnosis_status | string optional | |
encounter_id | string optional | |
from_date | string optional | |
limit | string optional | |
record_id | string optional | |
status_filter | string optional | |
to_date | string optional |
managePatientDrugsManage patient drugs and supplements.
Unified drug management for medications, supplements, and vitamins - prescribe medications, document supplements, manage drug interactions. Includes automatic allergy checking and comprehensive drug safety workflow for optimal patient care. Actions: - "add": Prescribe new drug (requires drug_name, directions for medications; drug_name, dosage for supplements) - "update": Modify existing prescription (requires record_id + fields to change). IMPORTANT: drug name and strength CANNOT be changed via update — use discontinue + add instead. Updatable fields: directions, dispense, refills, status. - "discontinue": Stop drug (requires record_id) - "list": Show all patient drugs by type (filter by substance_type, optionally filter by status)Substance Types:
Safety: Automatically checks allergies before prescribing unless check_allergies=False List filters:
When required parameters are missing, ask the user to provide the specific values rather than proceeding with defaults or auto-generated values.
| Parameters | Type | Description |
|---|---|---|
action | string | |
patient_id | string | |
check_allergies | string optional | |
comments | string optional | |
directions | string optional | |
dosage | string optional | |
dosage_unit | string optional | |
dose_form | string optional | |
drug_name | string optional | |
encounter_id | string optional | |
end_date | `st |
[...]
Content type
Image
Digest
sha256:23c0372dc…
Size
110.7 MB
Last updated
5 months ago
docker pull mcp/charmhealth-mcp-serverPulls:
49
Last week