openEHR Assistant Plugin

AI plugin suite for clinical workflow integration with openEHR systems. Adds skills, commands, agents, and hooks for Claude Code and Cursor that guide AI assistants through openEHR modeling, CKM discovery, and specification lookups.

This plugin works with the openEHR Assistant MCP Server, which provides the tools, prompts, and resources (CKM, guides, terminology, type specs). The plugin supplies the workflow layer: when to load which guides, which commands to offer, and how to stay aligned with openEHR best practices.

Recommended: For installation, transports, and MCP client configuration of the server (hosted vs local, streamable-http vs stdio), see the openehr-assistant-mcp README — Quick Start and Common client configurations.

Table of Contents

• Features
• Installation
• Setup (MCP server)
• Components
• Companion MCP Server
• Contributing
• License

Features

• Guide-first workflows — Skills and commands instruct the assistant to load relevant implementation guides from the MCP server before answering.
• Archetype authoring — Create, edit, extend, and specialize clinical archetypes with lint rules and idiom lookup.
• Template design — Build and constrain templates using the CGEM framework and narrowing principle.
• Composition building — Generate FLAT, STRUCTURED, and CANONICAL format instances.
• AQL queries — Write, explain, and optimize Archetype Query Language queries.
• CKM discovery — Search the Clinical Knowledge Manager for archetypes and templates.
• Demographic modeling — PARTY hierarchy, roles, relationships, identity patterns.
• Offline reference — Quick-reference, ADL/AQL syntax cheatsheets, and RM type reference in the repo when MCP is unavailable.

Installation

Claude Code — from the Cadasto marketplace:

/plugin marketplace add cadasto/plugin-marketplace
/plugin install openehr-assistant@cadasto

or directly from the repo: claude plugin add cadasto/openehr-assistant-plugin.

Cursor — Add the plugin via Cursor’s plugin flow (e.g. from a Git URL or local path). The repo includes a Cursor manifest at .cursor-plugin/plugin.json; skills, commands, agents, and MCP config are shared with the Claude plugin.

See docs/install.md for marketplace, local-development, update, and Cursor install details.

Contributors: See CONTRIBUTING.md for maintainer workflows, clone vs git archive (.gitattributes export-ignore), and how to bump compatibility with openehr-assistant-mcp.

Setup (MCP server)

This plugin expects the openEHR Assistant MCP Server to be configured in your client. The plugin ships with a default MCP config that points at the hosted server; you can override it for local or stdio use.

For server installation, transports (streamable-http vs stdio), and client-specific configuration (Claude Desktop, Cursor, LibreChat, Junie), see:

• openehr-assistant-mcp — Quick Start (hosted, Docker, stdio)
• openehr-assistant-mcp — Common client configurations

Environment variables (e.g. CKM_API_BASE_URL) and Docker/stdio details are documented in the MCP server README.

One server, not two. This plugin bundles its own .mcp.json, so it provides the openehr-assistant MCP server itself — prefer that. If you also added an openehr-assistant connector at claude.ai, the same tools appear twice (under a claude_ai namespace and the plugin's); that duplicate is optional. If a subagent reports CKM/guide tools "denied", it's a permission-policy gap, not a missing server — see the permissions.allow snippet in .claude/settings.json and docs/install.md.

Components

Skills

Commands

Multi-step workflows (authoring, review, AQL, compositions) are driven by the skills above, which auto-trigger from natural language. Commands are a small set of explicit one-shots:

Creating/editing/reviewing archetypes (incl. rationale prose and translation), linting, authoring templates, building compositions, writing AQL, and browsing guides are handled by the matching skill (no command needed) — just describe the task.

Agents

Companion MCP Server

The openehr-assistant-mcp server provides:

• 12 MCP tools (CKM search, guide access, terminology, type specs, ADL idioms, curated examples)
• 15 MCP prompts (guided clinical workflows)
• Implementation guides across six categories: archetypes/, templates/, aql/, simplified_formats/, specs/ (openEHR specification digests tracking the development branch), and howto/ (toolchain how-tos)
• Curated worked examples at openehr://examples/{kind}/{name} — AQL, FLAT, STRUCTURED payloads, and CKM-published reference .adl archetypes

Compatibility: This plugin version is built and tested against openehr-assistant-mcp v0.19.0 (releases). When updating the plugin, align with that server’s changelog so each plugin release stays compatible with a specific MCP server version.

Offline reference material in skills/openehr-assistant/reference/ includes a quick-reference (principles, rules, guide index), minimal ADL and AQL syntax cheatsheets, and an RM type reference (~30 commonly archetyped types with attributes for local lint rule 4 validation); see AGENTS.md (Syntax and grammar sources) for links to official specs and grammars.

See CHANGELOG.md for release notes.

Contributing

Contributions are welcome. Start with CONTRIBUTING.md and the docs/ references: install, testing & validation, versioning, and authoring conventions. Before opening a PR, run ./scripts/validate.sh and claude plugin validate . (CI runs the validator on every push). Please also review the Code of Conduct and Security Policy.

License

MIT License — Cadasto B.V.