Health Gorilla MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.2Updated Nov 14, 2026

Query Health Gorilla FHIR patients, conditions, medications and lab results.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Hosted MCP server that lets an assistant search Health Gorilla FHIR patient records and read conditions, medications, labs, documents and coverage.

What you can do
  • Find and read patients, including a full $everything record
  • List conditions, medications, allergies, immunizations and insurance coverage
  • List observations, diagnostic reports and document references, and fetch raw document content
  • Run arbitrary FHIR searches and poll asynchronous retrieval jobs
  • Create new patient records and start national-network Patient360 record retrieval
  • Check usage, request features, upgrade or cancel the subscription
When to use it
Useful when you work with Health Gorilla and want an assistant to look up patient charts, review medications, allergies or lab results, or pull external records through Patient360 without writing FHIR queries by hand.
Requirements
Remote streamable HTTP endpoint; no local install. Connect with the URL only — no API key or Authorization header. On first connect you sign in via OAuth with your Health Gorilla credentials, which are stored per user. A free plan allows 50 tool calls per month; paid plans are available.
Before you install
Handles protected health information, so patient data passes through the hosted service and the assistant. healthgorilla_create_patient writes a new record and healthgorilla_start_patient360_query imports external documents into your tenant; confirm before running them. Paid plans are billed through Stripe checkout links, and plan changes charge the price difference immediately with no refund for the current period.

Installation

In SourceWeft

  1. Open Health Gorilla MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fhealth-gorilla/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Health 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 /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "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

ToolTypeWhat it does
healthgorilla_find_patientsreadFind patients
healthgorilla_get_patientreadGet patient
healthgorilla_get_patient_everythingreadGet patient $everything
healthgorilla_list_conditionsreadList conditions
healthgorilla_list_medicationsreadList medications
healthgorilla_list_allergiesreadList allergies
healthgorilla_list_immunizationsreadList immunizations
healthgorilla_list_observationsreadList observations
healthgorilla_list_diagnostic_reportsreadList diagnostic reports
healthgorilla_list_documentsreadList documents
healthgorilla_get_coveragereadGet coverage
healthgorilla_get_binaryreadGet binary (document content)
healthgorilla_poll_query_statusreadPoll query status
healthgorilla_fhir_searchreadGeneric FHIR search
healthgorilla_create_patientwriteCreate patient
healthgorilla_start_patient360_querywriteStart Patient360 query
health_gorilla_usage_statusmetaUsage status (free-tier meter)
health_gorilla_request_featuremetaRequest a missing feature
health_gorilla_upgrademetaUpgrade to Pro or Pro+
health_gorilla_cancel_subscriptionmetaCancel 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

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run health_gorilla_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with health_gorilla_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with health_gorilla_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

Source: servers/health-gorilla/README.md at commit f22f848

Tools

16

healthgorilla_find_patients

Find patients

Search for patients by demographics. FHIR: GET /Patient?given=&family=&birthdate=&identifier=. Returns a FHIR searchset Bundle. Use the returned Patient id with the other tools.

Parametersgiven_countfamilybirthdateidentifier

healthgorilla_get_patient

Get patient

Read a single patient by id. FHIR: GET /Patient/{id}. Returns a FHIR Patient resource.

Parameterspatient_idrequired

healthgorilla_get_patient_everything

Get patient $everything

Fetch the comprehensive record for a patient as a FHIR Bundle. FHIR: GET /Patient/{id}/$everything. Optionally scope by _since and page with _count.

Parameters_count_sincepatient_idrequired

healthgorilla_list_conditions

List conditions

List a patient's conditions/problems. FHIR: GET /Condition?patient={id}. Returns a FHIR searchset Bundle.

Parameters_countcategorypatient_idrequired

healthgorilla_list_medications

List medications

List a patient's medication requests/prescriptions. FHIR: GET /MedicationRequest?patient={id}. Returns a FHIR searchset Bundle.

Parameters_countstatuspatient_idrequired

healthgorilla_list_allergies

List allergies

List a patient's allergies/intolerances. FHIR: GET /AllergyIntolerance?patient={id}. Returns a FHIR searchset Bundle.

Parameters_countpatient_idrequired

healthgorilla_list_immunizations

List immunizations

List a patient's immunizations. FHIR: GET /Immunization?patient={id}. Returns a FHIR searchset Bundle.

Parameters_countpatient_idrequired

healthgorilla_list_observations

List observations

List a patient's observations (labs, vitals). FHIR: GET /Observation?patient={id}. Filter by category (e.g. laboratory, vital-signs), LOINC code, or date. Returns a FHIR searchset Bundle.

Parameterscodedate_countcategorypatient_idrequired

healthgorilla_list_diagnostic_reports

List diagnostic reports

List a patient's diagnostic reports (lab panels, imaging). FHIR: GET /DiagnosticReport?patient={id}. Returns a FHIR searchset Bundle.

Parameters_countcategorypatient_idrequired

healthgorilla_list_documents

List documents

List a patient's document references (C-CDA, notes, etc). FHIR: GET /DocumentReference?patient={id}. Each entry points at a Binary you can fetch with healthgorilla_get_binary.

Parameterstype_countpatient_idrequired

healthgorilla_get_coverage

Get coverage

List a patient's insurance coverage. FHIR: GET /Coverage?patient={id}. Returns a FHIR searchset Bundle.

Parameterspatient_idrequired

healthgorilla_get_binary

Get binary (document content)

Retrieve raw document content by Binary id. FHIR: GET /Binary/{id}. Content may be a FHIR Binary JSON resource, XML C-CDA, or base64 — returned as-is (raw text if not JSON).

Parametersbinary_idrequired

healthgorilla_poll_query_status

Poll query status

Poll a RequestResult URL returned by healthgorilla_start_patient360_query. HTTP 202 = still processing, 200 = done (returns retrieval metrics: organizationsTotal, documentsFound, documentsImported, documentsSkipped, documentsFailed). Returns { status, body }.

Parametersrequest_result_urlrequired

healthgorilla_create_patient

Create patient

Registers a NEW patient record in your Health Gorilla tenant. FHIR: POST /Patient with a minimal FHIR R4 Patient resource built from the given args. State-changing.

ParameterscitylinegivenrequiredstatefamilyrequiredgenderrequiredbirthdaterequiredidentifierpostalCode

healthgorilla_start_patient360_query

Start Patient360 query

Initiates an asynchronous national-network records retrieval (CommonWell / Carequality / QHINs) that imports external documents into your tenant. FHIR: GET /DocumentReference/$p360-retrieve?patient={id} with header 'Prefer: respond-async'. Returns the RequestResult poll URL (Location header); poll it with healthgorilla_poll_query_status. State-changing.

Parameterspatient_idrequired

Version history

26
  1. v1.39.2LatestNov 14, 2026
  2. v1.39.1Nov 13, 2026
  3. v1.38.0Nov 12, 2026
  4. v1.37.3Nov 11, 2026
  5. v1.36.5Nov 8, 2026
  6. v1.36.4Nov 7, 2026
  7. v1.35.3Nov 5, 2026
  8. v1.35.2Nov 5, 2026
  9. v1.35.1Nov 4, 2026
  10. v1.35.0Nov 3, 2026
  11. v1.34.1Nov 3, 2026
  12. v1.33.0Nov 1, 2026
  13. v1.31.0Oct 31, 2026
  14. v1.30.0Oct 31, 2026
  15. v1.29.2Oct 30, 2026
  16. v1.29.0Oct 30, 2026
  17. v1.24.0Oct 26, 2026
  18. v1.21.3Oct 25, 2026
  19. v1.21.0Oct 25, 2026
  20. v1.20.0Oct 24, 2026
  21. v1.17.0Oct 23, 2026
  22. v1.16.4Oct 22, 2026
  23. v1.16.3Oct 21, 2026
  24. v1.11.1Oct 9, 2026
  25. v1.10.0Oct 9, 2026
  26. v1.0.0Sep 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations