/ Diretório / Playground / health-skillz
● Comunidade jmandel ⚡ Instantâneo

health-skillz

por 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.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

health-skillz-skill.replay ▶ pronto
0/0

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: health-skillz

Ask plain questions about your lab result trends

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

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

Fluxo
  1. Authenticate
    Use health-skillz to connect to my Epic MyChart account.✓ Copiado
    → Browser opens SMART launch; token stored locally
  2. Pull labs
    Show my LDL, HDL, and A1c over the past 3 years as a trend.✓ Copiado
    → Time-series table or summary with unit conversions
  3. Contextualize
    Relate these to the guideline ranges. Don't give me medical advice — just surface what's in range vs not.✓ Copiado
    → Explicit framing as reference ranges, not diagnosis

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

Armadilhas
  • 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

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

Fluxo
  1. Fetch active meds
    Use health-skillz. Pull my current medication list with dose, frequency, and prescribing provider.✓ Copiado
    → Structured list with RxNorm codes resolved to names
  2. Spot duplicates and gaps
    Any duplicate therapy, same-class redundancies, or meds that look expired?✓ Copiado
    → Flags you can raise with your doctor

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

Armadilhas
  • 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

Quando usar: You're consolidating records for a second opinion.

Fluxo
  1. Filter
    Use health-skillz. Pull all cardiology-related encounters, labs, and imaging from the last 2 years.✓ Copiado
    → Filtered export grouped by encounter
  2. Format
    Format as a one-page summary a specialist can skim in 30 seconds.✓ Copiado
    → Compact doc with key dates, diagnoses, pertinent findings

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

Armadilhas
  • Losing nuance by summarizing — Always bring the full export as backup; summary is for quick triage
Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

health-skillz-skill + filesystem

Save exports to an organized local folder structure

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

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
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

Custo e limites

O que custa rodar

Cota de API
Depends on the provider's FHIR API limits
Tokens por chamada
Moderate — lab results are compact
Monetário
Free (portal access is included with care)
Dica
Pull in one category at a time; full 'everything' exports are token-expensive.

Segurança

Permissões, segredos, alcance

Escopos mínimos: patient/*.read
Armazenamento de credenciais: OAuth token in local credential store; never committed
Saída de dados: Your FHIR server and Anthropic API only
Nunca conceda: user/*.write system/*.*

Solução de problemas

Erros comuns e correções

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.

Alternativas

health-skillz vs. outros

AlternativaQuando usarTroca
Manual portal exportOne-time export of all recordsPDF dump, not queryable
Apple Health appiOS-centric consumer aggregationClosed data; no LLM querying

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills