← Back to all docs

TherapyNotes MCP Server

The TherapyNotes MCP server lets AI agents read and write patient, scheduling, documentation, and billing data in TherapyNotes. Connect TherapyNotes to Claude, ChatGPT, and Cursor. Built and maintained by Supergood, since TherapyNotes doesn't ship an MCP server.

By Alex Klarfeld•May 12, 2026
TherapyNotes MCP Server

What is the TherapyNotes MCP server?

The TherapyNotes MCP server is a connector that lets AI agents (Claude, ChatGPT, Cursor, and other MCP clients) read and write patient, scheduling, documentation, and billing data in TherapyNotes through a standard protocol.

In short: TherapyNotes is an EHR and practice-management platform for behavioral health, covering the full lifecycle of care and revenue operations: scheduling and reminders, clinical documentation (intake, progress notes, treatment plans, discharge summaries), a patient portal, telehealth, insurance billing (CMS-1500 / 837P, ERA posting), and e-prescribing for authorized clinicians via DrFirst.

TherapyNotes doesn't ship an official MCP server, and TherapyNotes has no public API. Key scheduling, documentation, and billing operations live in the web app, and exports are limited and not event-driven, so a reverse-engineered connector is the realistic path to programmatic access. Supergood builds and maintains the connector by reverse-engineering TherapyNotes's authenticated web and portal flows and exposing them as MCP tools an agent can call directly, plus a normalized REST API underneath.

What you can do with TherapyNotes via MCP

Once connected, an agent can:

  • Look up patients and clients: demographics, contacts, portal status.
  • Pull and create appointments (office and telehealth) and attendance.
  • Retrieve notes (intake, progress, treatment plans, discharge) with signatures and lock state.
  • Get diagnoses and service codes (for example CPT 90834, 90837).
  • Pull insurance policies and subscriber details.
  • Submit claims (CMS-1500 / 837P) and reconcile ERA remittances; pull payments and invoices.
  • Retrieve documents and intake forms; manage the to-do task workflow.

How to connect TherapyNotes to Claude, ChatGPT & Cursor

Connecting works like any other MCP server. The short version:

  • Claude (Desktop or claude.ai): add the TherapyNotes MCP server under Settings → Connectors (or your MCP config), authorize the TherapyNotes account Supergood provisions, and the tools show up in any chat, including agent runs.
  • ChatGPT: add it as a connector under Settings → Connectors, authorize, and ChatGPT can call the TherapyNotes tools in conversations and in agent mode.
  • Cursor: add the server to your MCP config (mcp.json or Settings → MCP), reload, and the tools are available to the agent.

Supergood owns the auth piece (credentials, MFA, session refresh), so the connection doesn't drop. New to MCP? Our explainer covers what an MCP server is and how clients connect to one.

How Supergood builds the TherapyNotes MCP server

Supergood doesn't wait for TherapyNotes to ship an API. We reverse-engineer the authenticated web and portal flows behind TherapyNotes, normalize the responses, and wrap them as MCP tools, plus the underlying REST API if you'd rather call it from code.

  • Auth and MFA, handled. Supergood provisions a dedicated TherapyNotes account (email and phone managed by us) and keeps the session alive through MFA, token expiry, and re-auth.
  • Normalized data. Responses come back in consistent JSON shapes across modules, not the raw shape TherapyNotes's front-end happens to return.
  • Monitored and adapted. When TherapyNotes changes its web and portal UI or internal API, monitoring catches it and the connector gets patched, usually before it reaches you.
  • No public API, no problem. TherapyNotes never shipped a developer API; Supergood works the authenticated web and portal flows directly, handling MFA, locked notes, and session refresh.

Getting Started

  • Schedule Integration Assessment

Book a 30-minute call to confirm which TherapyNotes modules and workflows you need and how authentication should work.

  • Supergood Builds and Validates Your MCP Server

We deliver a hardened TherapyNotes connector (MCP tools plus the underlying API) scoped to your workflows and entitlements.

  • Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as TherapyNotes changes.

therapynotes

Use Cases

Practice-ops agent

- Answer "who's on my schedule and which intakes are outstanding" - Surface to-do tasks and overdue items - Confirm contact and insurance details

Documentation

- Pull the open progress note and treatment plan - Surface notes that still need a signature or are unlocked - Keep records consistent with another tool

Billing and RCM

- Submit CMS-1500 / 837P claims and reconcile ERAs - Surface denials and rejections - Reconcile payments against invoices

Patient engagement

- Send and chase intake forms and consents - Mirror portal messages into another tool - Surface new client requests

Technical Specifications

MCP transport

Remote MCP server over HTTPS; works with hosted MCP clients and with local MCP configs.

Authentication

Supergood provisions a dedicated TherapyNotes account (managed email and phone) and handles MFA; you can also bring your own credentials. Session refresh is automatic.

Supported clients

Claude (Desktop, claude.ai, Claude Code), ChatGPT connectors, Cursor, and other MCP-compatible clients.

Tools exposed

8 tools covering the workflows listed above; the set is scoped to the modules you license.

Data freshness

Near real-time reads and writes against TherapyNotes' live web app and patient portal.

Rate limits

Tuned to TherapyNotes's tolerances; Supergood paces requests to avoid tripping security throttles.

Latency

Sub-second for most reads under normal load; writes reflect the underlying platform timing.

Session management

Automatic re-auth plus cookie/token rotation, with health checks.

Security

Encrypted transport, scoped access, and audit logging; respects TherapyNotes role-based permissions.

Webhooks

Optional asynchronous delivery for long-running operations; polling otherwise.

Reliability

Retry logic, backoff, and idempotency keys to avoid duplicates.

Adaptation

Continuous monitoring for TherapyNotes web and portal surfaces changes, with rapid connector updates.

Frequently asked questions

No. TherapyNotes doesn't publish an MCP server. Supergood builds and maintains one by reverse-engineering TherapyNotes's authenticated flows and exposing them as MCP tools, plus the underlying REST API.

All of them, plus any MCP-compatible client. The same connector shows up in Claude (Desktop, claude.ai, Claude Code), ChatGPT connectors, and Cursor.

Supergood provisions a dedicated TherapyNotes account with managed MFA, or uses credentials you supply. We keep the session alive through MFA prompts, token expiry, and re-auth, so the connection stays live.

Yes. Reads and writes hit TherapyNotes's live system, not a nightly export. TherapyNotes has no public API. Key scheduling, documentation, and billing operations live in the web app, and exports are limited and not event-driven, so a reverse-engineered connector is the realistic path to programmatic access.

Both. The MCP tools are a layer on top of a normalized REST API for TherapyNotes; you can call either, from an agent or from your own code.

Related APIs in Behavioral Health / ABA

Behavioral Health / ABA

ABA Billing Services API

ABA Billing Services is a billing and revenue cycle management service focused on Applied Behavior Analysis (ABA) providers. In plain English: they help ABA clinics get paid—handling authorizations, eligibility checks, claims submission, posting remittances, and denial follow-up. An unofficial API would let you programmatically read and update authorizations, validate and submit sessions, build 837 claims, track payer statuses, and reconcile ERA/EOBs without living in spreadsheets and portals. If you’re another healthcare tech company—say an EHR, scheduling platform, or RCM analytics tool—integrating with ABA Billing Services means you can pull patient insurance details, authorizations, session validation results, claim statuses and remittances; push patient/provider rosters, billable session logs, and corrections with audit trails; and build features like authorization-aware scheduling, automatic claims assembly, real-time denial worklists, and utilization dashboards.

Behavioral Health / ABA

AuthentiCare from Fiserv/First Data API

AuthentiCare from Fiserv/First Data is software used to capture and verify in-home and community-based care visits so providers can get paid by Medicaid and Managed Care Organizations (MCOs). It tracks who delivered care, to whom, where, and for how long, then routes verified visits to billing. With an unofficial API, you could create and edit visits, synchronize patient and caregiver rosters from your EHR, validate authorizations before visits occur, assemble claims from verified visits, and reconcile payments end-to-end.

Behavioral Health / ABA

BHM Healthcare Solutions API

BHM Healthcare Solutions is a healthcare services organization focused on medical necessity review, external peer review (IRO), utilization management, and appeals. An unofficial API lets you submit prior auth and review cases, attach clinical documentation, track determinations, retrieve decision letters, and surface authorization numbers for downstream billing—directly from your own systems.

Behavioral Health / ABA

BehaviorLive API

BehaviorLive is a virtual events and continuing education platform built for behavior analysts and behavioral health teams. It hosts live and on‑demand CEU courses, manages registrations, verifies attendance, delivers certificates, and tracks CEUs in learner transcripts. With an unofficial API, you could sync staff rosters, bulk‑enroll employees in required CEUs, pull real‑time attendance and engagement data, auto‑issue certificates after quizzes, and export transcripts for compliance.

Behavioral Health / ABA

CareLogic by Qualifacts API

Programmatically access client demographics, program enrollments, scheduling, clinical documentation, payer authorizations, and claims in CareLogic with a stable REST API. Supergood builds and operates production-grade, unofficial CareLogic integrations so your team can automate behavioral health EHR and revenue cycle workflows without heavy custom engineering. CareLogic by Qualifacts is an EHR used by behavioral health and human services organizations to manage intake, treatment planning, progress notes, outcomes, scheduling, and reimbursement across Medicaid, commercial, and grant-funded programs. With an unofficial API, you could synchronize your client roster, manage episodes and program participation, create and complete appointments and notes, validate authorizations before service delivery, and assemble 837P claims with remittance tracking—end to end.

Behavioral Health / ABA

Careify API

Programmatically access Careify’s Electronic Visit Verification (EVV), authorizations, scheduling, and Medicaid reimbursement workflows with a stable REST API. In plain English: Careify is software that helps home and community-based service providers, clinics, and provider groups document care visits, verify time and location, track payer authorizations, and get paid. An unofficial API lets you create and verify EVV visits, sync patients and caregivers from your EHR, validate authorizations before scheduling, and automatically assemble claims from verified visits—all without manual portal work.

Ready to get a real API?