# io.github.kriskraw80/mychart (npm · mychart-mcp-server)

Connects to Epic MyChart patient portals: interactive login, list and download your own test results

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-07

## Components

- npm · `mychart-mcp-server`: 65/100 (this document), [markdown](https://verifymcp.io/servers/kriskraw80-mychart/mychart-mcp-server.md), [page](https://verifymcp.io/servers/kriskraw80-mychart/mychart-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `mychart-mcp-server`
- Version: `1.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-07.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Known CVEs were checked across the 98 of 102 dependencies we could resolve, so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Dependency health was assessed across the 98 of 102 dependencies we could resolve, so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 2 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 74/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1122 tokens (~140/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add kriskraw80-mychart -- npx -y mychart-mcp-server
```

### Codex

```bash
codex mcp add kriskraw80-mychart -- npx -y mychart-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kriskraw80-mychart": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mychart-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add kriskraw80-mychart --command npx --arg -y --arg mychart-mcp-server
```

### Hermes

```yaml
mcp_servers:
  kriskraw80-mychart:
    command: "npx"
    args: ["-y", "mychart-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "kriskraw80-mychart": {
      "command": "npx",
      "args": [
        "-y",
        "mychart-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-04 (score 65)

First indexed and scored.

## MCP tools (8)

### `mychart_set_provider` (~183 tokens)

Set MyChart Provider

Configure which health system's MyChart site to use. Every hospital system runs its own MyChart instance at its own URL, so this must be set once before logging in.

Args:
  \- url (string): Any URL from the provider's MyChart site — the login page URL pasted from a browser works fine (e.g. "https://mychart.virtua.org/MyChartPRD/Authentication/Login"). It is normalized to the instance root automatically.

Returns: The normalized base URL that was saved.

The setting persists in ~/.mychart-mcp/config.json. Changing providers invalidates any saved login session for the previous provider only in the sense that tools will now target the new site.

Input parameters:

- `url` (string, required): Any URL on your health system's MyChart site, e.g. https://mychart.virtua.org/MyChartPRD

### `mychart_login` (~202 tokens)

Log in to MyChart

Open a VISIBLE browser window at the configured MyChart login page and wait for the sign-in to complete. The user types their username/password and completes any MFA prompt directly in that window — credentials are never passed through the MCP client. (Optionally, if MYCHART_USERNAME and MYCHART_PASSWORD environment variables are set on the server process, the login form is pre-filled.)

Tip: check "Remember this device" during MFA so future logins skip the code.

The session is stored in a persistent browser profile (~/.mychart-mcp/browser-profile), so once logged in, all other tools work headlessly without repeating login until the session expires.

Args:
  \- timeout_seconds (number): How long to wait for the user to finish signing in (default 300, max 900).

Returns: { success, landedUrl, message }

Input parameters:

- `timeout_seconds` (integer): Seconds to wait for the user to complete sign-in (default 300)

### `mychart_session_status` (~64 tokens)

Check MyChart Session

Check whether a MyChart provider is configured and whether the saved browser session is still logged in. Runs headless; safe to call any time.

Returns: { configured, baseUrl, loggedIn, landedUrl }. If loggedIn is false, run mychart_login.

### `mychart_list_test_results` (~231 tokens)

List MyChart Test Results

Fetch the full list of test results from the MyChart portal (labs, imaging, pathology, etc.). Automatically expands lazy-loaded lists ("Show more") so every available result is returned, newest first as displayed by MyChart. Requires a logged-in session.

Returns: JSON with schema:
  {
    "count": number,
    "listUrl": string,          // the portal page that was scraped
    "results": [
      {
        "id": string,           // stable id for this session, e.g. "r1" — use with mychart_get_test_result / mychart_download_test_result
        "name": string,         // test name, e.g. "CBC WITH DIFFERENTIAL"
        "date": string?,        // collection/result date as shown by MyChart
        "url": string           // direct link to the result detail page
      }
    ]
  }

Error Handling:
  \- "Not logged in" -> run mychart_login first.
  \- If no results are recognized, use mychart_screenshot to inspect what the portal is showing.

### `mychart_get_test_result` (~135 tokens)

Get MyChart Test Result Details

Open one test result and return its full readable content — component values, reference ranges, flags, and provider comments — as text. Requires a logged-in session.

Args:
  \- result_id (string): An id from mychart_list_test_results (e.g. "r3"), or a full result-detail URL.

Returns: { id, name, date, url, text, truncated }. If truncated is true, use mychart_download_test_result for the complete PDF.

Input parameters:

- `result_id` (string, required): Result id from mychart_list_test_results (e.g. "r3") or a full result URL

### `mychart_download_test_result` (~162 tokens)

Download MyChart Test Result as PDF

Save one test result as a PDF file on disk (rendered from the result detail page). Requires a logged-in session.

Args:
  \- result_id (string): An id from mychart_list_test_results (e.g. "r3"), or a full result-detail URL.
  \- filename (string, optional): Base filename for the PDF; defaults to "<date> <test name>.pdf".

Files are saved to ~/.mychart-mcp/downloads. Returns: { path, bytes, id, name, date }.

Input parameters:

- `filename` (string): Optional base filename for the saved PDF
- `result_id` (string, required): Result id from mychart_list_test_results (e.g. "r3") or a full result URL

### `mychart_screenshot` (~100 tokens)

Screenshot Current MyChart Page

Debug aid: capture a full-page PNG of whatever page the automation browser is currently on (or the MyChart home page if idle). Useful when list/detail scraping reports nothing recognizable — the screenshot shows what the portal actually rendered.

Args:
  \- name (string, optional): Base filename for the PNG.

Returns: { path, url }. Screenshot is saved to ~/.mychart-mcp/downloads.

Input parameters:

- `name` (string): Optional base filename

### `mychart_close_browser` (~45 tokens)

Close MyChart Browser

Close the automation browser. The login session itself is preserved in the persistent profile on disk — this only frees the browser process. The next tool call relaunches it automatically.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/kriskraw80-mychart/mychart-mcp-server#diagnostics

## Score history

- 2026-08-07: 65
- 2026-08-06: 65
- 2026-08-05: 65
- 2026-08-04: 65

## Links

- npm package: https://www.npmjs.com/package/mychart-mcp-server
- Socket report: https://socket.dev/npm/package/mychart-mcp-server
- Repository: https://github.com/kriskraw80/mychart-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/kriskraw80-mychart/mychart-mcp-server.xml
- Changelog JSON feed: https://verifymcp.io/servers/kriskraw80-mychart/mychart-mcp-server.json
- HTML version of this page: https://verifymcp.io/servers/kriskraw80-mychart/mychart-mcp-server