Eir Open open.eir.space
Back to docs

Documentation

MCP Server

Load EIR health data files into Claude Desktop and any MCP-compatible AI client.

The EIR MCP Server lets you load .eir health data files directly into Claude Desktop and any MCP-compatible AI client. Ask questions about your medications, lab results, conditions, and care timeline — in natural language, with full privacy preserved.

Compatible Clients

Claude Desktop

Load your health records and chat with Claude about your medications, lab results, and care history.

Any MCP Client

Works with any application that implements the Model Context Protocol standard.

Privacy-First

All processing is local. Your health data is never sent to external servers.

Swedish Healthcare

Native support for Swedish medical terminology, 1177 records, and ICD-10-SE codes.

Install

Terminal window
npm install -g eir-mcp-server
# or
pip install eir-mcp-server

Configure

Add the server to your MCP client configuration.

Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "eir-healthcare": {
      "command": "eir-mcp-server",
      "args": []
    }
  }
}

Restart Claude Desktop after saving. The EIR tools will appear automatically.

Use It

Once configured, just describe what you want to do in natural language:

  1. Load your file — “Load my healthcare data from patient-2024.eir”
  2. Query medications — “What medications am I currently taking?”
  3. Analyze trends — “How has my HbA1c changed over time?”
  4. Get insights — “What should I be monitoring based on my conditions?”

Available Tools

The MCP server exposes seven tools that Claude can invoke on your behalf:

load_eir_file

Load any .eir file into context. Returns a patient summary, key metrics, and validation status.

query_medications

Retrieve current medications and treatment history, with optional filtering for active-only.

query_lab_results

Get lab results filtered by test name, date range, and including trend calculations.

query_conditions

Retrieve conditions and diagnoses with status filtering and optional ICD-10/SNOMED codes.

analyze_timeline

Generate a clinical timeline and care journey analysis across a given period.

validate_eir_file

Validate EIR format and content before loading, with optional strict-mode checking.

generate_summary

Create a health summary in brief, detailed, clinical, or patient-friendly format.

Get a .eir File

EIR files are health records exported in the open EIR format. You can get one from:

  • Chrome Extension — 1177 Journal Downloader exports your complete 1177.se journal with one click
  • Eir Viewer (macOS) — export from the desktop app after importing your 1177 records
  • Health.md Standard — if you’re building your own, see the EIR Health Data Standard