● Community
jmandel
⚡ Instant
health-skillz
by jmandel · jmandel/health-skillz
Connects Claude to your personal health records via SMART on FHIR — ask questions about your labs, meds, and visits without exporting anything.
A Claude skill that speaks SMART on FHIR, the industry-standard health data API. Lets Claude query your hospital portal as you, so you can ask plain-language questions about your lab values, medications, immunizations, and encounters.
Why use it
Key features
- 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
What it looks like in practice
health-skillz-skill.replay
▶ ready
Use Cases
Real-world ways to use health-skillz
When to use: You've had repeated labs over months/years and want to see the trajectory, not just each result in isolation.
Flow
-
Authenticate
Use health-skillz to connect to my Epic MyChart account.✓ Copied
→ Browser opens SMART launch; token stored locally
-
Pull labs
Show my LDL, HDL, and A1c over the past 3 years as a trend.✓ Copied
→ 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.✓ Copied
→ Explicit framing as reference ranges, not diagnosis
Outcome: A readable longitudinal view of your key labs — useful before your next appointment.
Pitfalls
- 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.
When to use: You're about to see a new specialist and want a clean, current med list.
Flow
-
Fetch active meds
Use health-skillz. Pull my current medication list with dose, frequency, and prescribing provider.✓ Copied
→ Structured list with RxNorm codes resolved to names
-
Spot duplicates and gaps
Any duplicate therapy, same-class redundancies, or meds that look expired?✓ Copied
→ Flags you can raise with your doctor
Outcome: A med list to hand your new provider on day one.
Pitfalls
- Portals sometimes miss OTC meds — Supplement manually; the portal only shows what was prescribed via it
When to use: You're consolidating records for a second opinion.
Flow
-
Filter
Use health-skillz. Pull all cardiology-related encounters, labs, and imaging from the last 2 years.✓ Copied
→ Filtered export grouped by encounter
-
Format
Format as a one-page summary a specialist can skim in 30 seconds.✓ Copied
→ Compact doc with key dates, diagnoses, pertinent findings
Outcome: A portable summary you own — not a 200-page PDF dump.
Pitfalls
- Losing nuance by summarizing — Always bring the full export as backup; summary is for quick triage
Combinations
Pair with other MCPs for X10 leverage
Save exports to an organized local folder structure
Save the cardiology export to ~/health/specialists/cardio-2026.md✓ Copied
Cost & Limits
What this costs to run
- API quota
- Depends on the provider's FHIR API limits
- Tokens per call
- Moderate — lab results are compact
- Monetary
- Free (portal access is included with care)
- Tip
- Pull in one category at a time; full 'everything' exports are token-expensive.
Security
Permissions, secrets, blast radius
Minimum scopes: patient/*.read
Credential storage: OAuth token in local credential store; never committed
Data egress: Your FHIR server and Anthropic API only
Never grant: 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.
Troubleshooting
Common errors and fixes
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.
Alternatives
health-skillz vs others
| Alternative | When to use it instead | Tradeoff |
|---|
| 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 |