What does the azure fhir mcp server do?

It connects Azure Fhir to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Azure Fhir directly.

How do I install the azure fhir mcp server?

Register the server in your MCP client's configuration file and restart the client. This page carries ready-made configuration blocks for Claude Desktop, Claude Code and Cursor.

What credentials does it need?

It reads `LOG_LEVEL`, `FASTMCP_SERVER_AUTH_AZURE_BASE_URL`, `FASTMCP_SERVER_AUTH_AZURE_REDIRECT_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

Azure Fhir MCP Server — Install Guide & Tools

What is the Azure Fhir MCP server?

Azure fhir mcp server connects Azure Fhir to AI assistants that speak the Model Context Protocol. A Model Context Protocol (MCP) server implementation for Azure Health Data Services FHIR (Fast Healthcare Interoperability Resources). This service provides a standardized interface for interacting with Azure FHIR servers, enabling healthcare data operations through MCP tools.

What Azure Fhir does

A Model Context Protocol (MCP) server implementation for Azure Health Data Services FHIR (Fast Healthcare Interoperability Resources). This service provides a standardized interface for interacting with Azure FHIR servers, enabling healthcare data operations through MCP tools.

Installing the azure fhir mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply 3 environment variables: LOG_LEVEL, FASTMCP_SERVER_AUTH_AZURE_BASE_URL, FASTMCP_SERVER_AUTH_AZURE_REDIRECT_PATH. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Cloud and DevOps servers put infrastructure on speaking terms with your assistant, so "why is this broken?" is answered from real state rather than a generic checklist. Azure Fhir sits in that group. Worth comparing against the other cloud devops servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
It will not start until its required credentials are present, so set those before wondering why the tools never appear.
Maintained by erikhoward, written in Python.
MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the azure fhir mcp server actually does with your data.
Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

How to install the Azure Fhir MCP server

{
    "mcpServers": {
        "fhir": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "azure-fhir-mcp-server"
            ],
            "env": {
                "fhirUrl": "https://your-fhir-server.azurehealthcareapis.com/fhir",
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
                "tenantId": "your-tenant-id"
            }
        }
    }
}

Configuration as documented by the project. Restart the client after saving.

Variable	Description	Required
LOG_LEVEL	Configuration value read at startup.	Optional
FASTMCP_SERVER_AUTH_AZURE_BASE_URL	Endpoint or connection string the server talks to.	Yes
FASTMCP_SERVER_AUTH_AZURE_REDIRECT_PATH	Filesystem location the server is allowed to use.	Optional

Variable

Description

Required

LOG_LEVEL

Configuration value read at startup.

Optional

FASTMCP_SERVER_AUTH_AZURE_BASE_URL

Endpoint or connection string the server talks to.

Yes

FASTMCP_SERVER_AUTH_AZURE_REDIRECT_PATH

Filesystem location the server is allowed to use.

Optional

Azure Fhir MCP Server

What is the Azure Fhir MCP server?

What Azure Fhir does

Installing the azure fhir mcp server

Configuration

Where it fits

Practical notes

How to install the Azure Fhir MCP server

Configuration

Frequently asked questions

Alternatives to the Azure Fhir MCP server

Supabase

n8n

AWS

Browserbase

Cloudflare

Grafana