FHIR MCP Server

MCP server providing seamless access to FHIR APIs for AI tools and healthcare applications. Its 6 documented tools cluster into read & search, create & write, update, delete. It runs locally over stdio via the published package.

People connecting science & health tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-07-14 · ★ 132 · #10 OF 60 MAINTAINED SCIENCE & HEALTH · VERIFIED 2026-08-25

Apache-2.0 · Python servers · how we verify → /methodology

01 · Install FHIR MCP Server

before you install - you'll need

Set FHIR_SERVER_ACCESS_TOKEN, FHIR_SERVER_BASE_URL, FHIR_SERVER_CLIENT_ID, FHIR_MCP_HOST, FHIR_MCP_PORT before connecting. FHIR_SERVER_CLIENT_SECRET, FHIR_SERVER_SCOPES are optional or environment-specific per the README.

Claude Code

claude mcp add wso2-fhir-mcp-server -- uvx fhir-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "wso2-fhir-mcp-server": {
      "command": "uvx",
      "args": [
        "fhir-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

pypi package fhir-mcp-server - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.wso2 is GitHub-verified and matches the repo owner

03 · What FHIR MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can retrieve metadata about a specified FHIR resource type, including its supported search parameters and custom operations, execute a FHIR "create" interaction to persist a new resource of the specified type, and execute a FHIR "delete" interaction on a specific resource instance.

Capability map

Tools grouped from the project's README - what FHIR MCP Server lets an agent do.

read & search

3 tools - e.g. Retrieves metadata about a specified FHIR resource type, including its supported search parameters and custom operations.; Executes a standard FHIR search interaction on a given resource type, returning a…

get_capabilities · search · read

create & write

1 tool - e.g. Executes a FHIR "create" interaction to persist a new resource of the specified type.

create

update

1 tool - e.g. Performs a FHIR "update" interaction by replacing an existing resource instance's content with the provided payload.

update

delete

1 tool - e.g. Execute a FHIR "delete" interaction on a specific resource instance.

delete

Latest releases

0.10.0 · 2025-10-30

Enable agents to retrieve authenticated user's FHIR profile information · Update README.md · Temporarily removed Docker installation section in README · Use fetch_raw to retrieve full bundles instead of entries · Add…

0.9.0 · 2025-07-22

Initial implementation and project setup for FHIR MCP server · Add dynamic authentication toggling CLI options · Add docker support · Test cases for the fhir mcp server · Add e2e tests for MCP tools · Update the readme…

04 · Who maintains FHIR MCP Server

FHIR MCP Server is maintained by wso2. It's the only MCP server we track from this author; the repo dates to Jun 2025.

05 · Facts

category
science & health - ranked #10 of 60 actively-maintained science & health servers as of 2026-08-25.
registry
io.github.wso2/fhir-mcp-server (active, first published 2026-03-31)
packages
pypi:fhir-mcp-server

06 · FHIR MCP Server FAQ

Is FHIR MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-14. We re-verify nightly.

What can FHIR MCP Server do?

With this server connected, an agent can retrieve metadata about a specified FHIR resource type, including its supported search parameters and custom operations, execute a FHIR "create" interaction to persist a new resource of the specified type, and execute a FHIR "delete" interaction on a specific resource instance.

How do I install FHIR MCP Server?

Run `uvx fhir-mcp-server`. The README documents 7 environment variables (FHIR_SERVER_ACCESS_TOKEN, FHIR_SERVER_BASE_URL, FHIR_SERVER_CLIENT_ID…) to set first. Set FHIR_SERVER_ACCESS_TOKEN, FHIR_SERVER_BASE_URL, FHIR_SERVER_CLIENT_ID, FHIR_MCP_HOST, FHIR_MCP_PORT before connecting. FHIR_SERVER_CLIENT_SECRET, FHIR_SERVER_SCOPES are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does FHIR MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to FHIR MCP Server