FHIR Tools

v1.0.0Databasesstable

A collection of tools for working with FHIR data, designed to be used with Large Language Models via the Model Context Protocol.

mcp-fhir-toolsmcpai-integration
Share:
19
Stars
0
Downloads
0
Weekly
0/5

What is FHIR Tools?

FHIR Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to collection of tools for working with fhir data, designed to be used with large language models via the model context protocol.

A collection of tools for working with FHIR data, designed to be used with Large Language Models via the Model Context Protocol.

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A collection of tools for working with FHIR data, designed t

Use Cases

Work with FHIR healthcare data.
Process medical records through natural language.
aehrc

Maintainer

LicenseApache-2.0
Languagetypescript
Versionv1.0.0
UpdatedApr 14, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-fhir-tools

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use FHIR Tools

The MCP FHIR Tools server provides AI assistants with a collection of utilities for working with Fast Healthcare Interoperability Resources (FHIR) data, including resource validation against official FHIR standards, UUID generation for FHIR identifiers, and Australian-specific healthcare identifier tools. It exposes packages for general FHIR utilities (fhir-tools), Australian healthcare identifiers (au-fhir-tools), and terminology services for code lookup and validation (tx-tools). Healthcare developers and informaticists use it to validate patient records, generate identifiers, and look up medical codes through natural language without leaving their AI assistant.

Prerequisites

  • Node.js 18 or later installed
  • npx available in your PATH (comes with Node.js)
  • An MCP-compatible client such as Claude Desktop or Goose
  • Optional: access to a FHIR terminology server (e.g. tx.fhir.org) for code validation
1

Install and run via npx

The simplest way to start the server is with npx, which downloads and runs the latest version automatically. No global install is required.

npx -y mcp-fhir-tools
2

Add to Claude Desktop configuration

Open your claude_desktop_config.json and add the mcp-fhir-tools entry.

{
  "mcpServers": {
    "fhir-tools": {
      "command": "npx",
      "args": ["-y", "mcp-fhir-tools"]
    }
  }
}
3

Restart your MCP client

Restart Claude Desktop to load the FHIR tools server. No environment variables are required for basic operation.

4

Validate a FHIR resource

Ask your AI assistant to validate a FHIR JSON resource. The 'validate' tool accepts the resource JSON, a FHIR version string, and an optional terminology server URL.

5

Generate a UUID for a FHIR identifier

Use the 'generate-uuid' tool to create a random UUID v4 suitable for use as a FHIR resource identifier.

FHIR Tools Examples

Client configuration

Claude Desktop configuration for the MCP FHIR Tools server. No API keys are required.

{
  "mcpServers": {
    "fhir-tools": {
      "command": "npx",
      "args": ["-y", "mcp-fhir-tools"]
    }
  }
}

Prompts to try

Example prompts for working with FHIR data through the server.

- "Validate this FHIR Patient resource against version 4.0.1: { \"resourceType\": \"Patient\", ... }"
- "Generate a new UUID I can use as a FHIR identifier."
- "Check this FHIR Observation resource against the Australian terminology server at https://tx.fhir.org.au."
- "Validate my MedicationRequest resource and tell me if there are any errors."

Troubleshooting FHIR Tools

Validation returns unexpected errors for a valid resource

Check that you are specifying the correct fhirVersion parameter (e.g. '4.0.1' for R4). Different FHIR versions have different validation rules and required fields.

Terminology server errors during code validation

The default terminology server (tx.fhir.org) may have rate limits or downtime. Pass an alternative txServer URL in your validate call, or omit it to skip terminology validation.

npx -y mcp-fhir-tools fails to start

Ensure Node.js 18+ is installed ('node --version'). If the package is not found, try clearing the npm cache with 'npm cache clean --force' and retrying.

Frequently Asked Questions about FHIR Tools

What is FHIR Tools?

FHIR Tools is a Model Context Protocol (MCP) server that collection of tools for working with fhir data, designed to be used with large language models via the model context protocol. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install FHIR Tools?

Follow the installation instructions on the FHIR Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with FHIR Tools?

FHIR Tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is FHIR Tools free to use?

Yes, FHIR Tools is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-fhir-tools": { "command": "npx", "args": ["-y", "mcp-fhir-tools"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use FHIR Tools?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides