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`.

What credentials does it need?

It reads `EHRBASE_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

OpenEHR MCP Server

# openEHR MCP Server An MCP (Model Context Protocol) server designed to interface with openEHR REST APIs, specifically the EHRbase implementation.

Local serverstdioPython

What is the OpenEHR MCP Server?

openEHR MCP Server An MCP (Model Context Protocol) server designed to interface with openEHR REST APIs, specifically the EHRbase implementation. This server

Configuration

A working Docker installation * Python 3 (this project was built with python 3.12, earlier versions might work) * A Python virtual environment (pip, conda or uv) * Install the required dependencies in your Python environment:

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
openehr_template_list	List all available openEHR templates from the EHRbase server
openehr_template_get	Retrieve a specific openEHR template by its unique identifier
openehr_template_example_composition	Generate an example openEHR composition based on a specific template
openehr_ehr_create	Create a new EHR in the system
openehr_ehr_get	Retrieve an EHR by its ID
openehr_ehr_list	List all available EHRs in the system
openehr_ehr_get_by_subject	Get an EHR by subject ID and namespace
openehr_composition_create	Create a new openEHR composition in the Electronic Health Record
openehr_composition_get	Retrieve an existing openEHR composition by its unique identifier
openehr_composition_update	Update an existing openEHR composition in the Electronic Health Record
openehr_composition_delete	Delete an existing openEHR composition from the Electronic Health Record
openehr_query_adhoc	Execute an ad-hoc AQL query against the openEHR server

How to install the OpenEHR MCP Server

{
  "mcpServers": {
    "openEHR": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network=host",
        "-e","EHRBASE_URL=http://localhost:8080/ehrbase/rest",
        "-e","EHRBASE_JSON_FORMAT=wt_flat",
        "ctodeakai/openehr-mcp-server:latest"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

A working Docker installation * Python 3 (this project was built with python 3.12, earlier versions might work) * A Python virtual environment (pip, conda or uv) * Install the required dependencies in your Python environment: