fhir — Claude Code skill: clinical data access
This Claude Code skill connects to FHIR R4 servers and extracts structured findings from patient records. It activates for requests to access a live EHR or retrieve clinical notes.
no license 111 installs ★ 456 updated 2026-08-27
npx skills add anthropics/healthcare --skill fhir -a claude-codeWhat fhir does
The skill retrieves a patient’s clinical data and notes from a FHIR R4 server, then passes note text to clinical-note-extract for structured analysis. It searches for a patient by name, date of birth, or MRN before fetching the requested resources; date filters can narrow the time window.
It orchestrates the fhir MCP server bundled with the healthcare plugin. Node must be on PATH. A secured hospital endpoint needs its FHIR R4 base URL and the organization’s registered client_id; authentication uses SMART. In headless environments, connect returns a sign-in URL. The skill itself does not write files to disk.
What it helps with
- connect to an EHR and locate a patient
- retrieve patient notes from a specified date range
- extract structured findings from clinical records
Example prompts for the agent
- Connect to the EHR and find the patient by MRN.
- Retrieve notes about the patient's back pain from the last six months.
- Extract structured findings from the patient's clinical records.
How to install fhir
1Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir -a claude-code2Manually: put the files in place
~/.claude/skills/fhir/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fhir/
1Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir -a codex2Manually: put the files in place
.agents/skills/fhir/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir -a cursor2Manually: put the files in place
.cursor/skills/fhir/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install anthropics/healthcare plugins/healthcare/skills/fhir2Manually: put the files in place
.github/skills/fhir/SKILL.md1Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir -a gemini-cli2Platform CLI
gemini skills install https://github.com/anthropics/healthcare --path plugins/healthcare/skills/fhirManually: put the files in place
.devin/skills/fhir/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about fhir
How do I install fhir in Claude Code?
Run npx skills add anthropics/healthcare --skill fhir -a claude-code. The skill file is placed at ~/.claude/skills/fhir/SKILL.md.
What does fhir do?
It connects to an FHIR R4 server, retrieves patient data and notes, then sends note text to clinical-note-extract for structured extraction.
What does fhir need to work?
The healthcare plugin must load its fhir MCP server, and Node must be on PATH. A secured EHR also requires its FHIR R4 base URL and the organization’s registered client_id.