openEHR MCP Server

Name: openEHR MCP Server
Author: deak-ai

@deak-ai

Repository

About openEHR MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openehr-mcp-server": {
      "command": "docker",
      "args": [
        "compose",
        "up",
        "-d"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is openEHR MCP Server?

An MCP (Model Context Protocol) server that interfaces with openEHR REST APIs, specifically the EHRbase implementation. It allows MCP clients like Claude Desktop to create and submit compositions for openEHR templates to a server. Intended for developers integrating clinical data via openEHR.

How to use openEHR MCP Server?

Run the pre-built Docker container with environment variables EHRBASE_URL (required) and EHRBASE_JSON_FORMAT (optional). Configure Claude Desktop by adding an "openEHR" block under mcpServers in claude_desktop_config.json. For local development, use the provided Docker Compose to start an EHRbase instance, then upload a template and create an EHR using Python helper scripts.

Key features of openEHR MCP Server

List and retrieve openEHR templates
Create, retrieve, list, and search EHRs
Create, read, update, and delete compositions
Execute ad-hoc AQL queries
Prompt for capturing vital signs
Docker-based deployment for easy setup

Use cases of openEHR MCP Server

Capture vital signs for a patient into an openEHR composition
Manage electronic health records (create, read, update, delete)
Run ad-hoc AQL queries against an openEHR server
Automate template-driven composition creation in clinical workflows
Prototype openEHR integrations with AI assistants

FAQ from openEHR MCP Server

What dependencies are required?

An EHRbase server, an openEHR template uploaded to that server, and an existing EHR with its ID for compositions.

What JSON formats are supported?

You can set EHRBASE_JSON_FORMAT to wt_flat (default, simplified data types based on web template), canonical (canonical openEHR JSON), or wt_structured (currently not working).

How do I set up a local EHRbase for testing?

Use the provided docker-compose.yml in the docker-compose directory. Start with docker compose up -d, then upload a template via scripts/upload_template.py and create an EHR via scripts/create_ehr.py.