The Azure AHDS FHIR MCP Server provides a Model Context Protocol (MCP) interface for interacting with Azure FHIR servers to perform healthcare data operations:
Search FHIR Resources: Perform searches on FHIR resources using specific search parameters via the search_fhir tool
Access Resource Collections: Retrieve collections of standard FHIR resources (Patient, Observation, Medication) via MCP resource protocol (e.g., fhir://Patient/)
Access Specific Resources: Retrieve specific FHIR resources by ID (e.g., fhir://Observation/{id})
Secure Authentication: Utilize OAuth2 for secure access with client ID, client secret, and tenant ID
Developer-Friendly: Supports local development environments with customizable logging levels
Allows loading configuration from .env files for development environments, supporting variables like fhirUrl, clientId, clientSecret, and tenantId.
Enables contributions through GitHub's pull request workflow, with specific guidance on forking and submitting changes.
Supports development setup with Linux-specific virtual environment creation commands.
Provides specific installation paths and configuration guidance for running on macOS systems.
Built on Python 3.13+, offering a Pythonic implementation of the MCP server for Azure FHIR integration.
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.
Requires Python 3.13 or higher and uv.
Install uv first.
1 - Edit Claude Desktop Configuration:
Open claude_desktop_config.json and add the following configuration.
On MacOs, the file is located here: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json.
On Windows, the file is located here: %APPDATA%\Claude Desktop\claude_desktop_config.json.
The following is a table of available environment configuration variables:
Variable | Description | Default |
| Logging level |
|
| Azure FHIR server URL | Required |
| OAuth2 client ID | Required |
| OAuth2 client secret | Required |
| Azure AD tenant ID | Required |
2 - Restart Claude Desktop.
search_fhir - Search for FHIR resources based on a dictionary of search parameters
The server provides access to all standard FHIR resources through the MCP resource protocol:
fhir://Patient/ - Access all Patient resources
fhir://Patient/{id} - Access a specific Patient resource
fhir://Observation/ - Access all Observation resources
fhir://Observation/{id} - Access a specific Observation resource
fhir://Medication/ - Access all Medication resources
fhir://Medication/{id} - Access a specific Medication resource
And many more...
1 - Clone the repository:
2 - Create and activate virtual environment:
Linux/macOS:
Windows:
3 - Install dependencies:
4 - Copy and configure environment variables:
Edit .env with your settings:
5 - Claude Desktop Configuration
Open claude_desktop_config.json and add the following configuration.
On MacOs, the file is located here: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json.
On Windows, the file is located here: %APPDATA%\Claude Desktop\claude_desktop_config.json.
6 - Restart Claude Desktop.
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m '✨ Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request
Licensed under MIT - see LICENSE.md file.
This is not an official Microsoft or Azure product.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/erikhoward/azure-fhir-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server