For patients
Connect your AI assistant to your health record
Ask Claude, ChatGPT or another AI app about your own test results, visits and bills. Sign in with your ChartVoyant patient portal account, create a read-only key, and paste it into the app you use.
The key can only read. It cannot book, cancel, message your office, pay a bill or change anything.
How it works
Three steps, about two minutes. Your practice must use ChartVoyant, and you need a patient portal account there.
Sign in
Use the same username and password as the ChartVoyant patient portal. No portal account yet? Ask your office's front desk, or register at portal.chartvoyant.com.
Create a read-only key
Name it after the app you'll use and choose how long it lasts: 30 days, 90 days, 6 months or a year. It's shown once, so copy it.
Add it to your AI app
Paste the connector URL into Claude or ChatGPT, or the key into Claude Code, Cursor, VS Code, Gemini CLI and other apps that support MCP. Then just ask.
Sign in with your patient portal account
Signing in here does not sign you out of the portal anywhere else. Nothing is saved in this browser.
Forgot your password? Your office's front desk can send a new sign-up link. Already signed in to the portal? You can also create keys there, under Account → AI assistants.
Your AI assistant keys
You have no keys at this office yet.
Your key is ready — copy it now
It won't be shown again. Treat it like a password: anyone who has it can read your record at this office until it expires or you revoke it.
- Open claude.ai (or the Claude desktop app) and go to Customize → Connectors.
- Choose Add custom connector, name it ChartVoyant and paste the connector URL.
- For sign-in, choose No sign-in (the key is already in the URL), then Add.
- In a chat, turn the connector on from the + menu and ask, for example: “Explain my newest lab result.” It's then available in the Claude mobile app too.
On the free plan Claude allows one custom connector. Menu names can differ slightly between versions.
- ChatGPT connects to MCP servers on paid plans, from the web. In Settings, turn on Developer mode.
- Add a new app (connector), name it ChartVoyant, paste the connector URL and choose no authentication.
- In a new chat, turn on Developer mode from the + menu, pick ChartVoyant, and ask your question.
OpenAI moves these settings from time to time; look for Developer mode under Settings → Apps, or Security.
In a terminal:
Add this to ~/.cursor/mcp.json (or Settings → MCP → Add):
For GitHub Copilot in VS Code, add this to .vscode/mcp.json or run MCP: Add Server:
Add this to ~/.gemini/settings.json:
Any app that supports remote MCP servers over HTTP works. Give it the server URL and the header Authorization: Bearer <your key>, or — if it only takes a URL — the connector URL. An app that can only start local servers can use the mcp-remote bridge:
What the AI app can and can't see
The key reads the same record the patient portal shows you, at one office, and nothing more.
It can read
Your upcoming and past visits, test results your care team has released, signed visit summaries, active medications, problems and allergies, your bills and payments, and the messages you've sent from the portal.
It can't
Book or cancel visits, message the office, request refills, pay, or change anything. It can't see results the office hasn't released, draft notes, or anyone else's record.
You stay in control
Every key expires. Revoke one here or in the portal under Account → AI assistants and it stops working at once. Each time an app reads your record, it is recorded in your practice's audit log.
Questions
Which AI apps work?
Anything that supports the Model Context Protocol (MCP) with a remote server: Claude (web, desktop and mobile), ChatGPT on paid plans, Claude Code, Cursor, GitHub Copilot in VS Code, Gemini CLI and many others.
I lost my key, or it stopped working.
Keys can't be shown again. Create a new one, put it in your app, and revoke the old one. A key stops working when it expires, when you revoke it, or if your portal account is turned off.
I'm seen at two offices that use ChartVoyant.
A key reads one office's record. After you sign in, pick the office, create a key, then pick the other office and create a second one. Add both to your app.
Does ChartVoyant send my record to an AI company?
No. Nothing is shared until you create a key and give it to an app yourself. ChartVoyant never asks for your key — if someone does, don't share it.
I'm a developer.
The patient MCP server documentation covers the endpoint, protocol versions, tools and limits.