MyChart / FHIR Connection

HealthViewer can connect directly to your health system’s patient portal using the FHIR standard, pulling lab results without needing a PDF at all.

Supported Systems

Any health system that exposes a FHIR R4 endpoint with patient access works. This includes most major US health networks using Epic (MyChart) or Cerner.

How to Connect

1. Click Import → Connect Health System
2. Search for your health system by name or browse the list
3. Click Connect — your browser (or a secure webview) will open your health system’s login page
4. Sign in with your patient portal credentials
5. Authorize HealthViewer to read your health records
6. HealthViewer fetches your lab results and shows a preview to review before saving

What Gets Imported

• Lab results (Observations) with values, units, and reference ranges
• Result dates
• Panel/order names where available

Medications, conditions, and other clinical data are not imported in the current version.

Authorization & Privacy

• HealthViewer uses OAuth 2.0 — your portal password is never seen or stored by HealthViewer
• Authorization tokens are stored encrypted in your local .hvdb file
• Tokens are used only to fetch your data; HealthViewer makes no other requests to your health system
• You can revoke HealthViewer’s access at any time through your patient portal’s connected apps settings

Refreshing Data

After the initial connection, you can re-import to pick up new results. Go to Import → Connect Health System, find your connected system, and click Sync.

Troubleshooting

My health system isn’t listed Try searching by hospital name, city, or parent network. If still not found, your health system may not expose a public FHIR endpoint. Use the PDF upload path instead.

Authorization fails or times out Make sure you’re using your patient portal credentials (not employee/provider credentials). Some systems require you to have an active MyChart account — register at your health system’s patient portal first.

Results are missing or incomplete FHIR availability varies by health system. Some labs may only be available in older PDF exports. Try downloading a PDF from your portal and uploading it to capture any gaps.