health-skillz MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

OAuth-based authentication against any FHIR-compliant provider
Read-only by default — no prescribing or charting
Supports all major US hospital portals (Epic MyChart, Cerner, Athena)
Parses clinical codes (LOINC, RxNorm, SNOMED) back to human language
Open-source — you see exactly what's queried

Live-Demo

In der Praxis

health-skillz-skill.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

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

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "health-skillz-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "health-skillz-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jmandel/health-skillz",
          "~/.claude/skills/health-skillz"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add health-skillz-skill -- git clone https://github.com/jmandel/health-skillz ~/.claude/skills/health-skillz

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: health-skillz

Ask plain questions about your lab result trends

👤 Patients tracking chronic conditions, cholesterol, A1c ⏱ ~15 min beginner

Wann einsetzen: You've had repeated labs over months/years and want to see the trajectory, not just each result in isolation.

Voraussetzungen

A patient portal with FHIR access — Most major US health systems support SMART on FHIR — check your portal for API/app access
Skill installed — git clone https://github.com/jmandel/health-skillz ~/.claude/skills/health-skillz

Ablauf

Authenticate

Use health-skillz to connect to my Epic MyChart account.✓ Kopiert

→ Browser opens SMART launch; token stored locally
Pull labs

Show my LDL, HDL, and A1c over the past 3 years as a trend.✓ Kopiert

→ Time-series table or summary with unit conversions
Contextualize

Relate these to the guideline ranges. Don't give me medical advice — just surface what's in range vs not.✓ Kopiert

→ Explicit framing as reference ranges, not diagnosis

Ergebnis: A readable longitudinal view of your key labs — useful before your next appointment.

Fallstricke

Treating Claude's output as medical advice — Always bring questions to your actual clinician. This skill is for understanding your own records, not a second opinion.

Reconcile the medication list before an appointment

👤 Patients on multiple meds from multiple providers ⏱ ~10 min beginner

Wann einsetzen: You're about to see a new specialist and want a clean, current med list.

Ablauf

Fetch active meds

Use health-skillz. Pull my current medication list with dose, frequency, and prescribing provider.✓ Kopiert

→ Structured list with RxNorm codes resolved to names
Spot duplicates and gaps

Any duplicate therapy, same-class redundancies, or meds that look expired?✓ Kopiert

→ Flags you can raise with your doctor

Ergebnis: A med list to hand your new provider on day one.

Fallstricke

Portals sometimes miss OTC meds — Supplement manually; the portal only shows what was prescribed via it

Export a relevant subset of records for a new specialist

👤 Patients changing providers or seeing a specialist ⏱ ~20 min intermediate

Wann einsetzen: You're consolidating records for a second opinion.

Ablauf

Filter

Use health-skillz. Pull all cardiology-related encounters, labs, and imaging from the last 2 years.✓ Kopiert

→ Filtered export grouped by encounter
Format

Format as a one-page summary a specialist can skim in 30 seconds.✓ Kopiert

→ Compact doc with key dates, diagnoses, pertinent findings

Ergebnis: A portable summary you own — not a 200-page PDF dump.

Fallstricke

Losing nuance by summarizing — Always bring the full export as backup; summary is for quick triage

Kombinieren mit: filesystem

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

health-skillz-skill + filesystem

Save exports to an organized local folder structure

Save the cardiology export to ~/health/specialists/cardio-2026.md✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
smart_launch	provider URL	First-time connection to a provider	OAuth redirect
get_observations	patient id, category, date range	Pulling labs or vitals	FHIR API call
get_medications	patient id, status	Med reconciliation	FHIR API call
get_encounters	patient id, date range	Visit history review	FHIR API call

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Depends on the provider's FHIR API limits
Tokens pro Aufruf: Moderate — lab results are compact
Kosten in €: Free (portal access is included with care)
Tipp: Pull in one category at a time; full 'everything' exports are token-expensive.

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: patient/*.read

Credential-Speicherung: OAuth token in local credential store; never committed

Datenabfluss: Your FHIR server and Anthropic API only

Niemals gewähren: user/*.write system/*.*

This is NOT medical advice. The skill surfaces your own records; decisions remain with you and your clinicians.
Health data is sensitive. Understand that by querying via Claude, excerpts of your records are sent to Anthropic's API per their data policies.
Revoke the app's access from your patient portal when you're done.

Fehlerbehebung

Häufige Fehler und Lösungen

SMART launch fails with redirect error

Most portals require pre-registering the app's redirect URI. Check the skill's docs for your provider.

Empty results despite having data in portal

Your provider may restrict FHIR scopes; try narrower queries or contact support.

Lab codes show as raw LOINC IDs

Ensure the skill's code map is current; may need to update the clone.

Prüfen: cd ~/.claude/skills/health-skillz && git pull

Alternativen

health-skillz vs. andere

Alternative	Wann stattdessen	Kompromiss
Manual portal export	One-time export of all records	PDF dump, not queryable
Apple Health app	iOS-centric consumer aggregation	Closed data; no LLM querying

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen