FHIR
Enables seamless integration with FHIR APIs for healthcare applications, allowing users to search, retrieve, create, update, and analyze clinical information through natural language interactions. Supports SMART-on-FHIR authentication and works with
What is FHIR?
FHIR is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables seamless integration with fhir apis for healthcare applications, allowing users to search, retrieve, create, update, and analyze clinical information through natural language interactions. sup...
Enables seamless integration with FHIR APIs for healthcare applications, allowing users to search, retrieve, create, update, and analyze clinical information through natural language interactions. Supports SMART-on-FHIR authentication and works with
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables seamless integration with FHIR APIs for healthcare a
Use Cases
Maintainer
Works with
Installation
PIP
pip install fhir-mcp-serverManual Installation
pip install fhir-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use FHIR
The FHIR MCP Server enables AI assistants to interact directly with FHIR-compliant electronic health record (EHR) systems through natural language. It supports reading, searching, creating, updating, and deleting FHIR resources such as patients, observations, and clinical documents, and handles both direct access-token authentication and full SMART-on-FHIR OAuth2 flows. Healthcare developers, clinical informaticists, and integration engineers can use it to query patient data from systems like HAPI FHIR or Epic without writing raw API calls.
Prerequisites
- Python 3.10 or later with uv package manager installed
- Access to a FHIR R4 server (e.g., HAPI FHIR public sandbox or an Epic FHIR endpoint)
- A FHIR_SERVER_BASE_URL and either an access token or OAuth2 client credentials
- An MCP-compatible client such as Claude Desktop or Claude Code
Install the package with uvx
The recommended installation uses uvx, which creates an isolated environment. Alternatively install with pip.
uvx fhir-mcp-server
# or
pip install fhir-mcp-serverIdentify your FHIR server URL and credentials
You need the base URL of your FHIR server (e.g., https://hapi.fhir.org/baseR4). For authenticated servers obtain an access token or OAuth2 client_id and client_secret from your EHR vendor.
Set required environment variables
At minimum set FHIR_SERVER_BASE_URL. For OAuth2 also set FHIR_SERVER_CLIENT_ID, FHIR_SERVER_CLIENT_SECRET, and FHIR_SERVER_SCOPES. For public servers set FHIR_SERVER_DISABLE_AUTHORIZATION=True.
export FHIR_SERVER_BASE_URL=https://hapi.fhir.org/baseR4
export FHIR_SERVER_DISABLE_AUTHORIZATION=TrueAdd the server to your MCP client configuration
Edit your claude_desktop_config.json to wire up the server with the necessary environment variables passed in the env block.
Restart your MCP client and test
Restart Claude Desktop or your client. Confirm connectivity by asking the AI to retrieve server capabilities or search for a patient resource.
FHIR Examples
Client configuration
Claude Desktop config using uvx to run fhir-mcp-server against the public HAPI FHIR sandbox.
{
"mcpServers": {
"fhir": {
"command": "uvx",
"args": ["fhir-mcp-server"],
"env": {
"FHIR_SERVER_BASE_URL": "https://hapi.fhir.org/baseR4",
"FHIR_SERVER_DISABLE_AUTHORIZATION": "True"
}
}
}
}Prompts to try
These prompts map to the search, read, create, update, and delete tools exposed by the server.
- "What FHIR resource types does this server support?"
- "Search for all Patient resources with family name Smith"
- "Get the Observation resources for patient ID 12345"
- "Create a new Patient resource for John Doe born 1985-03-15"
- "Update the phone number on Patient resource 12345"
- "Delete Observation resource obs-999 from the server"Troubleshooting FHIR
Authentication errors when connecting to Epic or other production FHIR servers
Production EHR systems require registered OAuth2 client credentials and specific SMART scopes (e.g., 'patient/*.read'). Set FHIR_SERVER_CLIENT_ID, FHIR_SERVER_CLIENT_SECRET, and FHIR_SERVER_SCOPES with the values from your app registration.
uvx command not found
Install the uv package manager first: curl -LsSf https://astral.sh/uv/install.sh | sh, then restart your terminal. Alternatively use 'pip install fhir-mcp-server' and run 'fhir-mcp-server' as the command.
Requests time out on large searches
Increase the FHIR_MCP_REQUEST_TIMEOUT environment variable (default is 30 seconds). Use narrower search parameters to reduce result set size.
Frequently Asked Questions about FHIR
What is FHIR?
FHIR is a Model Context Protocol (MCP) server that enables seamless integration with fhir apis for healthcare applications, allowing users to search, retrieve, create, update, and analyze clinical information through natural language interactions. supports smart-on-fhir authentication and works with It connects AI assistants to external tools and data sources through a standardized interface.
How do I install FHIR?
Install via pip with: pip install fhir-mcp-server. Then configure your AI client to connect to this MCP server.
Which AI clients work with FHIR?
FHIR works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is FHIR free to use?
Yes, FHIR is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
FHIR Alternatives — Similar Business Applications Servers
Looking for alternatives to FHIR? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up FHIR in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use FHIR?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.