About Health Gorilla MCP by usefulapi
Health Gorilla MCP by usefulapi is a hosted server for querying Health Gorilla FHIR records. It gives healthcare teams MCP tools to search patients and retrieve clinical information, with a tool to create patients and start Patient360 queries.
Key features
- 01Find and retrieve patient records
- 02Query conditions, medications, allergies, and immunizations
- 03Read observations, reports, and documents
- 04Search FHIR resources
- 05Create patients and start Patient360 queries
Use cases
- 01Find a patient and review their clinical records
- 02Look up medications, allergies, or lab-related reports
- 03Run a Patient360 query for a patient
MCP support
Exposes Health Gorilla FHIR search and patient-record operations as tools for MCP clients. The hosted server accepts Health Gorilla credentials during sign-in.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://health-gorilla.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-health-gorilla https://health-gorilla.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-health-gorilla":{"type":"http","url":"https://health-gorilla.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-health-gorilla":{"type":"http","url":"https://health-gorilla.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-health-gorilla":{"type":"http","url":"https://health-gorilla.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-health-gorilla":{"serverUrl":"https://health-gorilla.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
16| Parameter | Type | Required | Description |
|---|---|---|---|
| given | string | No | Given (first) name. |
| _count | integer | No | FHIR _count — max results per page. |
| family | string | No | Family (last) name. |
| birthdate | string | No | Date of birth, yyyy-mm-dd. |
| identifier | string | No | Business identifier (e.g. MRN), optionally system|value. |
Details
From the project READMEHealth Gorilla MCP by usefulapi
Query Health Gorilla FHIR patients, conditions, medications and lab results. Hosted, no local install.
Live endpoint: https://health-gorilla.usefulapi.io/mcp · Homepage: https://usefulapi.io
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://health-gorilla.usefulapi.io/mcp. - Claude Code:
claude mcp add --transport http health-gorilla https://health-gorilla.usefulapi.io/mcp, then run/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"health-gorilla": {
"url": "https://health-gorilla.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Health Gorilla credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/health-gorilla/
On first connect you'll paste your Health Gorilla credentials. They are validated, stored per-user, and scoped to you — no keys in config files.
Tools
| Tool | Type | What it does |
|---|---|---|
healthgorilla_find_patients | read | Find patients |
healthgorilla_get_patient | read | Get patient |
healthgorilla_get_patient_everything | read | Get patient $everything |
healthgorilla_list_conditions | read | List conditions |
healthgorilla_list_medications | read | List medications |
healthgorilla_list_allergies | read | List allergies |
healthgorilla_list_immunizations | read | List immunizations |
healthgorilla_list_observations | read | List observations |
healthgorilla_list_diagnostic_reports | read | List diagnostic reports |
healthgorilla_list_documents | read | List documents |
healthgorilla_get_coverage | read | Get coverage |
healthgorilla_get_binary | read | Get binary (document content) |
healthgorilla_poll_query_status | read | Poll query status |
healthgorilla_fhir_search | read | Generic FHIR search |
healthgorilla_create_patient | write | Create patient |
healthgorilla_start_patient360_query | write | Start Patient360 query |
health_gorilla_usage_status | meta | Usage status (free-tier meter) |
health_gorilla_request_feature | meta | Request a missing feature |
health_gorilla_upgrade | meta | Upgrade to Pro (unlimited*) |
health_gorilla_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro | $9/mo or $90/yr (2 months free) | Unlimited* |
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with health_gorilla_upgrade (it returns a Stripe Checkout link). Cancel any time with health_gorilla_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running health_gorilla_upgrade before then undoes the cancel. Or write to [email protected].
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.