How to Use the Epic Fhir MCP in Claude

Pull live patient charts, lab results, and medication histories from Epic directly into your Claude Desktop chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Epic Fhir MCP to Claude Desktop

Create your Vinkius account to connect Epic Fhir to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Epic Fhir with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Search and Summarize Patient Records

This MCP server connects Claude to Epic's FHIR API. You can ask your agent to find a patient by name or MRN using `search_patients`, and then pull their complete demographic profile with `get_patient`. It's all the core data—name, DOB, contact info, identifiers—ready for your next prompt. Once you have the patient, your agent can build a quick summary. Ask it to pull all known diagnoses with `list_conditions` and current prescriptions with `list_medications`. Claude can then format this into a clean, readable brief, saving you the time of digging through the EHR yourself.

Review Clinical History in Claude Desktop

Get a full timeline of a patient's care. Your agent can use `list_encounters` to pull up every visit, from routine check-ups to hospital stays. You can also check for upcoming visits with `list_appointments` or review their vaccination history using `list_immunizations`. Because this runs in Claude Desktop, you can cross-reference this data with local files. For example, pull a patient's history and compare it to notes in a local text file without ever leaving the chat. Your agent has the context from both the Epic FHIR API and your machine.

Analyze Labs and Diagnostics

Stop hunting for lab results. Have your agent fetch them for you. It can use `list_diagnostic_reports` to get full text reports or pull structured data like vitals and lab values with `list_observations`. You can even filter observations by category, like 'vital-signs' or 'laboratory'. And before you do anything, you can run a quick safety check. The `list_allergies` tool pulls all known allergies and intolerances, including the substance, reaction, and severity. It's a simple command that gives you critical information upfront.

Setup guide

Set up Epic Fhir MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Epic Fhir MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Epic Fhir MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under epic-fhir-mcp.

json

{
  "mcpServers": {
    "epic-fhir-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Epic Fhir. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Epic Fhir now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Epic Fhir MCP in Claude Desktop

It gives your Claude Desktop agent 10 tools to directly query Epic's FHIR API. You can ask it to `search_patients`, then `list_conditions` and `list_medications` for that patient. The agent then synthesizes this live data into a summary right in your chat.

Yes, you can. The tools work with all versions of Claude Desktop and the web client. For the desktop app, you'll add the server to your local config file. For the web version, you just paste the MCP server URL as a custom connector.

Claude Desktop runs the MCP server as a local process, which is great for development or accessing local resources. The web app connects to a remote, public URL, which means zero installation and you can use it from any browser. Both give you access to the same 10 Epic Fhir tools.

No, it's straightforward. For the desktop app, you edit a single JSON configuration file to point to the server. On the web, you just paste the server URL into the Custom Connectors section in your settings. You'll be querying patient data in minutes.

Vinkius handles the connection, but your PHI from Epic is only passed through ephemeral, zero-trust environments. The server processes requests for data like Patient demographics, Conditions, and Medications, but it doesn't store any of it. All data is in-transit between Epic and your client.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript