Skip to content
MCP server

Insync MCP

MCP server for an InSync Healthcare patient portal: records, messages and requests

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.5.0
Listing updated
today

Similar MCP servers

About Insync MCP

Insync MCP is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

Aimed at patients of practices that use InSync Healthcare (Qualifacts) behavioral-health portals, this server reads appointments, medications, allergies, secure messages, forms, surveys, documents, profile and account balance, and downloads portal files. It can also upload an insurance-card image and send secure messages, refill requests, appointment requests and cancellation requests.

It is explicit that it is not read-only. Every send is annotated destructive and confirm-gated: the first call returns a preview and a confirmToken, and only a second call carrying that token sends. Opening an unread message can mark it read, so insync_get_message is gated behind allow_mark_read. Sends that return a server error come back as status unknown so a model checks before retrying.

Sign-in is either a username and password held in memory or a browser bridge that holds no credentials. The README says the refill, appointment, cancellation and upload sends have not yet been exercised live.

Install

Run in a terminal

claude mcp add insync-mcp --env INSYNC_PORTAL='<INSYNC_PORTAL>' --env INSYNC_PASSWORD='<INSYNC_PASSWORD>' -- npx -y @chrischall/insync-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "insync-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/insync-mcp"
      ],
      "env": {
        "INSYNC_PORTAL": "<INSYNC_PORTAL>",
        "INSYNC_PASSWORD": "<INSYNC_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "insync-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/insync-mcp"
      ],
      "env": {
        "INSYNC_PORTAL": "<INSYNC_PORTAL>",
        "INSYNC_PASSWORD": "<INSYNC_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "insync-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/insync-mcp"
      ],
      "env": {
        "INSYNC_PORTAL": "<INSYNC_PORTAL>",
        "INSYNC_PASSWORD": "<INSYNC_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "insync-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/insync-mcp"
      ],
      "env": {
        "INSYNC_PORTAL": "<INSYNC_PORTAL>",
        "INSYNC_PASSWORD": "<INSYNC_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "insync-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/insync-mcp"
      ],
      "env": {
        "INSYNC_PORTAL": "<INSYNC_PORTAL>",
        "INSYNC_PASSWORD": "<INSYNC_PASSWORD>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • INSYNC_PORTALYour practice's portal, scheme and host only, e.g. https://<practice>intouch.insynchcs.com.Required
  • INSYNC_USERNAMEPortal username. Set with INSYNC_PASSWORD to sign in server-side. Leave both empty to relay through your signed-in browser tab.
  • INSYNC_PASSWORDPortal password. A rejected sign-in is never retried automatically, because the portal counts failures toward a lockout.
  • INSYNC_TRANSPORTserver or fetchproxy. Default: server when both credentials are set, otherwise fetchproxy.
  • INSYNC_WS_PORTOverride the fetchproxy WebSocket port (default 37149).
  • INSYNC_OUTPUT_DIRWhere downloaded files are written locally (a path-delimiter list; ~ expands). Default ~/Downloads and ~/Documents. A per-call dest must resolve inside one of these.
  • INSYNC_INLINE_DOWNLOADSLocal installs: true returns a downloaded file inline (up to 10 MiB) instead of writing it to disk; larger files are still saved. Ignored when hosted, which always delivers inline or by signed link. Default false.
  • FETCHPROXY_WS_HOSTBind interface for the fetchproxy concentrator, a literal IP only (default 127.0.0.1). Keep on loopback; it exists for hosted deployments that run each MCP in its own network namespace.
  • FETCHPROXY_IDENTITY_DIRAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

insync_get_message
Reads a message; opening an unread one can mark it read.
insync_list_messages
Lists messages.
insync_list_message_recipients
Lists practice groups for new messages.
insync_send_message
Sends a new secure message.
insync_reply_message
Replies to a message.
insync_get_refill_options
Looks up refill options.
insync_request_refill
Requests a medication refill.
insync_find_appointment_slots
Finds open appointment slots.
insync_request_appointment
Requests an appointment in an open slot.
insync_list_appointments
Lists appointments.
insync_cancel_appointment
Requests cancellation of an appointment.
insync_upload_slots
Gets signed upload URLs on a hosted server.

What it does

Portal reads
Appointments, medications, allergies, messages, forms and balance.
Secure messaging
Send new messages and replies, each behind a confirm gate.
Requests
Refill, appointment and cancellation requests.
Insurance-card upload
Uploads front and back images with vetting and preview.
Mark-as-read guard
Unread messages are not opened without allow_mark_read.
Two auth modes
Server-side login or a credential-free browser bridge.

Good for

  • Review upcoming appointments and medications
  • Send a secure message to the practice
  • Request a medication refill after previewing it
  • Download a document or message attachment

Pricing

Open source

Insync MCP FAQ

Is it read-only?

No. It sends messages and requests and can upload an image, with each write requiring a confirm token.

Which portals does it target?

InSync Healthcare (Qualifacts) patient portals at intouch.insynchcs.com.

Are the writes tested?

New messages and replies were verified live; refill, appointment, cancellation and card upload sends have not been exercised.

How are credentials handled?

With INSYNC_USERNAME and INSYNC_PASSWORD they live in memory only; without them the browser bridge holds none.

Is Insync MCP free?

Yes. Insync MCP is open source, so you can use and self-host it for free.

How do I add Insync MCP to Claude Code?

Run this command in your terminal: claude mcp add insync-mcp --env INSYNC_PORTAL='<INSYNC_PORTAL>' --env INSYNC_PASSWORD='<INSYNC_PASSWORD>' -- npx -y @chrischall/insync-mcp

What are the best alternatives to Insync MCP?

The closest alternatives to Insync MCP are Tooluniverse, Oya Browser, BasalFit, Ebi Ols and Clinicaltables.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers