CardioCode

ESC Guidelines as AI-Powered Clinical Tools

58 clinical decision support tools for cardiology.

---

Setup

Step 1: Download

git clone https://github.com/miltosdoc/cardiocode.git
cd cardiocode

Already have it? Run cd cardiocode && git pull to update.

Step 2: Install

Mac/Linux:

pip3 install -e . && pip3 install mcp pymupdf

Windows:

pip install -e . && pip install mcp pymupdf

Step 3: Choose Your Claude

Option A: Claude Code (Recommended)

If you have Claude Code installed:

claude

Select "Yes" when prompted to trust the folder. Done!

Option B: Claude Desktop

If you use Claude Desktop, add CardioCode to your config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cardiocode": {
      "command": "python3",
      "args": ["-m", "cardiocode.mcp.server"],
      "cwd": "/full/path/to/cardiocode"
    }
  }
}

Replace /full/path/to/cardiocode with your actual path (e.g., /Users/yourname/cardiocode).

On Windows, use "command": "python" instead.

Restart Claude Desktop. Look for the hammer icon to confirm tools loaded.

---

Usage

Just ask clinical questions:

• "Calculate CHA2DS2-VASc for 72yo woman with CHF and HTN"
• "HFrEF patient on ACE-I only, LVEF 30% - what's next?"
• "Search guidelines for aortic stenosis intervention"

---

58 Clinical Tools

Category	Tools
Risk Calculators	CHA2DS2-VASc, HAS-BLED, GRACE, Wells PE, PESI, sPESI, Geneva, HCM Risk-SCD, MAGGIC, LMNA, LQTS, Brugada
Valvular Disease	AS, AR, MR, TR, MS - severity & intervention timing
Device Therapy	ICD, CRT, Pacing indication & mode
VTE/PE	Risk stratification, Thrombolysis, Outpatient eligibility
Heart Failure	HFrEF treatment optimization, Device therapy pathway
Syncope	Risk stratification, Etiology classification
Knowledge Search	Search all 11 ESC guidelines

---

Disclaimer

Decision support tool only. Not a replacement for clinical judgment.

---

Built for cardiologists, by cardiologists.