# Insync MCP

> Insync MCP is an open-source MCP server for health and science. MCP server for an InSync Healthcare patient portal: records, messages and requests. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/chrischall/insync-mcp
- **MCP Registry name:** io.github.chrischall/insync-mcp
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [BasalFit](https://ai-powered.com/mcp/basalfit): BasalFit is a free MCP server for health and science.
- [Ebi Ols](https://ai-powered.com/mcp/ebi-ols): Ebi Ols is a freemium MCP server for health and science.
- [Clinicaltables](https://ai-powered.com/mcp/clinicaltables): Clinicaltables is a freemium MCP server for health and science.
- [Complex Portal](https://ai-powered.com/mcp/complex-portal): Complex Portal is a freemium MCP server for health and science.
- [Idigbio](https://ai-powered.com/mcp/idigbio): Idigbio is a freemium MCP server for health and science.
- [Ensembl](https://ai-powered.com/mcp/ensembl): Ensembl is a freemium MCP server for health and science.

---
Source: https://ai-powered.com/mcp/insync-mcp
