# Health Gorilla MCP by usefulapi

> Health Gorilla MCP by usefulapi is a freemium MCP server for health and science. Hosted MCP connector for querying Health Gorilla FHIR patient records from AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/health-gorilla/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/health-gorilla
- **MCP Registry name:** io.usefulapi/health-gorilla
- **Categories:** health and science
- **Listing updated:** 2026-11-18

## About

The server sits between an AI client such as Claude, ChatGPT or Cursor and the Health Gorilla FHIR API, so a user can ask for a patient's conditions, medications, allergies, immunizations or lab results in plain language. The README and site say it is hosted at a remote Streamable HTTP endpoint, so there is nothing to install locally; sign-in happens through an OAuth login page that asks for a Health Gorilla access token.

The toolset is 20 tools in total. Fourteen are read-only queries covering patients, observations, diagnostic reports, documents and coverage, plus a generic FHIR search fallback. Two tools can create a patient record or start a Patient360 retrieval from national networks, and the site notes that clients ask for confirmation before those run. Four meta tools report usage, submit feature requests and manage the Pro subscription.

The operator states that this is an independent service, not affiliated with Health Gorilla, and that it does not sign HIPAA Business Associate Agreements. The site tells users not to send protected health information through it, so it fits developer testing and non-PHI workflows rather than clinical use.

## Features

- **Patient record queries:** Search patients by demographics and pull conditions, medications, allergies and immunizations from FHIR resources.
- **Lab and report access:** List observations such as labs and vitals, plus diagnostic reports and document references.
- **Document retrieval:** Fetch raw document content such as C-CDA files through the binary lookup tool.
- **Generic FHIR search:** Run arbitrary FHIR searches when the dedicated tools do not cover a query.
- **OAuth sign-in:** Connect by URL alone; the server handles login so no API key goes into the client config.
- **Metered usage tiers:** Free plan includes 50 tool calls a month, with paid Pro and Pro+ plans for higher limits.

## Good for

- Testing how an AI assistant summarises FHIR patient data from Health Gorilla
- Checking a patient's recent lab results through a chat interface
- Reviewing a patient's active medications and allergies during development of a health app
- Exploring FHIR resource queries before building a custom integration

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http health-gorilla https://health-gorilla.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://health-gorilla.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "health-gorilla": {
      "url": "https://health-gorilla.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "health-gorilla": {
      "type": "http",
      "url": "https://health-gorilla.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "health-gorilla": {
      "serverUrl": "https://health-gorilla.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "health-gorilla": {
      "type": "http",
      "url": "https://health-gorilla.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `healthgorilla_find_patients`: Search for patients by demographics.
- `healthgorilla_get_patient`: Read a single patient by id.
- `healthgorilla_get_patient_everything`: Fetch the comprehensive record for a patient as a FHIR Bundle.
- `healthgorilla_list_conditions`: List a patient's conditions or problems.
- `healthgorilla_list_medications`: List a patient's medication requests or prescriptions.
- `healthgorilla_list_allergies`: List a patient's allergies or intolerances.
- `healthgorilla_list_immunizations`: List a patient's immunizations.
- `healthgorilla_list_observations`: List a patient's observations such as labs and vitals.
- `healthgorilla_list_diagnostic_reports`: List a patient's diagnostic reports.
- `healthgorilla_list_documents`: List a patient's document references.
- `healthgorilla_get_coverage`: List a patient's insurance coverage.
- `healthgorilla_get_binary`: Retrieve raw document content by Binary id.
- `healthgorilla_poll_query_status`: Poll a RequestResult URL from a Patient360 query.
- `healthgorilla_fhir_search`: Run an arbitrary FHIR search.
- `healthgorilla_create_patient`: Register a new patient record.
- `healthgorilla_start_patient360_query`: Start an asynchronous national-network records retrieval.
- `health_gorilla_usage_status`: Report current usage and plan limits.
- `health_gorilla_request_feature`: Send a request for a missing feature.
- `health_gorilla_upgrade`: Get a Pro or Pro+ paid plan.
- `health_gorilla_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official Health Gorilla product?

No. The site says usefulapi is an independent service, not affiliated with or endorsed by Health Gorilla.

### Can I use it with protected health information?

The site says no. It advises against using the server with PHI and states that no HIPAA Business Associate Agreements are signed.

### What does the free plan include?

The Free plan allows 50 tool calls per month. Pro is listed at $9 per month or $90 per year with 10,000 calls, and Pro+ at $39 per month or $390 per year with 100,000 calls.

### Can the AI change data in my Health Gorilla account?

Two of the 16 Health Gorilla tools can create or change data, namely creating a patient and starting a Patient360 query. The site says most MCP clients ask for approval before a tool call runs.

### Is Health Gorilla MCP by usefulapi free?

Health Gorilla MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Health Gorilla MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http health-gorilla https://health-gorilla.usefulapi.io/mcp

### What are the best alternatives to Health Gorilla MCP by usefulapi?

The closest alternatives to Health Gorilla MCP by usefulapi are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/health-gorilla-mcp-by-usefulapi
