SimplePractice MCP Server

Планирование, первичный приём, балансы клиентов и статус страховых требований для терапевтических практик.

Размещённый MCP-сервер

npx add-mcp 'https://cotlet.dev/mcp/v1/simplepractice'

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

SimplePractice API and MCP server: Let your AI agent run your practice admin.

SimplePractice has no public API and no MCP server for practices (checked 27 Oct 2026). Cotlet runs 13 SimplePractice tools hosted, over MCP for agents and REST for scripts, in your own login.

Read SimplePractice schedules and administrative records through MCP or REST. Connect your authorized account to an agent or private reporting workflow.

MCP setup REST API guide

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by SimplePractice. SimplePractice is a trademark of its owner. If SimplePractice's own integrations cover what you need, use them first.

What can you automate in SimplePractice?

  • Triage new appointment requests
  • Send intake before a first session
  • Book a client's next session
  • Mark no-shows and late cancels
  • Follow up on denied claims
  • Chase overdue client balances

Does SimplePractice have an MCP server or an API?

  • The help center says SimplePractice "doesn't currently offer a public-facing API for integrations with other software or platforms."
  • Its only API, launched in 2022 and now called SimpleConnect, lets health plans and EAPs request appointments with in-network clinicians. Practices cannot use it.
  • Zapier and n8n list no SimplePractice app, so automations today run on calendar sync, email alerts and report downloads.
What you needSimpleConnectGitHub MCP serverCotlet
Open to a practiceHealth plans and EAPs onlyYesYes
Clinician side: requests, intake, claimsAppointment requests onlyClient Portal view onlyYes
Writes: accept, share, messageNoRead-onlyYes, you approve each
Works from Claude or ChatGPTNoDesktop apps onlyYes, hosted

Checked 27 Oct 2026. Sources: SimplePractice Help Center: Comparing features by plan (FAQ on API), SimplePractice Enterprise launches API (press release), Zapier app directory (no SimplePractice app)

How does Cotlet connect to SimplePractice?

  1. Sign in to SimplePractice. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. Run your workflow. Ask your agent or send an HTTP request.

We never keep your SimplePractice password, and no tool reads progress notes.

Connect SimplePractice to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

  1. Sign in to SimplePractice. Create a Cotlet account, open SimplePractice in its Cloud Browser, sign in with your two-factor code and press Enable for agents.
  2. Add the server address. Enter https://cotlet.dev/mcp/v1 where your agent takes an MCP server or a custom connector.
  3. Approve the agent. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

The shared address https://cotlet.dev/mcp/v1 carries SimplePractice next to your other apps. Turned SimplePractice on after connecting? Refresh the connector so its tools appear.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet-simplepractice \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet-simplepractice": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet-simplepractice]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: simplepractice_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: simplepractice_read

How to use the SimplePractice REST API

Create your Cotlet API key

Create a Cotlet API key with access to SimplePractice and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Sign in to SimplePractice in its Cotlet Cloud Browser and enable the app for agents. Your owner or team role must permit the calendar, client or billing records you request.

Make your first SimplePractice API request

REST:

curl "https://cotlet.dev/api/v1/simplepractice/appointments?from=2026-10-28&to=2026-10-28" \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read administrative schedule records

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "simplepractice",
  "tool": "list_appointments",
  "result": {
    "appointments": [
      {
        "appointment_id": "ap_5021",
        "start": "2026-10-28T09:00:00-07:00",
        "duration_minutes": 53,
        "client": "Jordan Avery",
        "client_id": "cl_3104",
        "clinician": "Dr. Sam Lee",
        "service": "90837",
        "location": "Telehealth",
        "status": "Show",
        "first_session": false
      }
    ]
  }
}

Replace the dates with your reporting range and read result.appointments. This operation has no cursor or page-size input; timestamps keep their offset and duration uses minutes.

Compare appointment times and status as well as IDs. Pending requests are separate and require list_appointment_requests.

These reads do not return progress notes or clinical documents. Keep administrative reports in a permitted private destination and retain the access and privacy limits described on this page.

SimplePractice workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestRead appointment records into a permitted private administrative schedule without changing appointments.
MakeHTTP > Make a requestRead pending appointment requests into a staff review queue without accepting or rejecting requests.
Python or Node.jsREST APIRead claims and claim details into a private denied-or-rejected administration queue without submitting claims.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads SimplePractice; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

SimplePractice API endpoints and MCP tools

Calendar and requests

Requests from Therapy Finder and the Optum portal expire after 72 hours. A status change can create an invoice and an AutoPay charge.

  • List appointments (list_appointments, read): Appointments on the calendar in a date range, with client, service and status.
  • List appointment requests (list_appointment_requests, read): Pending requests from the Requests page, with source and requested time.
  • Accept appointment request (accept_appointment_request, write, asks first): Accepts a pending request and sends the client the confirmation email.
  • Decline appointment request (decline_appointment_request, write, asks first): Declines a pending request with a reason and emails the client.
  • Create appointment (create_appointment, write, asks first): Books an appointment for an existing client on the calendar.
  • Set appointment status (set_appointment_status, write, asks first): Sets Show, No show, Canceled, Late canceled or Clinician canceled.

Clients and the Client Portal

Intake goes from your shareable documents. A Secure Message reaches one client and holds up to 5,000 characters.

  • Find client (find_client, read): Clients and contacts by name, email or phone, with status and portal access.
  • Share intake documents (share_intake_documents, write, asks first): Shares intake forms through the Client Portal and emails the client.
  • Send secure message (send_secure_message, write, asks first): Sends a Secure Message to one client through the Client Portal.

Billing and insurance claims

Balances by aging bucket and claims by status. A claim without Payment Reports stops at Accepted.

  • List outstanding balances (list_outstanding_balances, read): Clients who owe money, grouped by age as the client invoice aging report shows.
  • Get client billing (get_client_billing, read): A client's balance and unpaid invoices from their Billing page.
  • List claims (list_claims, read): Insurance claims with payer, date of service and claim status.
  • Get claim (get_claim, read): One claim's details, status history and the payer's remarks.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/simplepractice-api-mcp-server#tools

Who can see my SimplePractice session, and how do I revoke it?

  • What we store. Your signed-in SimplePractice profile, AES-256-GCM encrypted, in Finland. Never the password.
  • What your agent gets. The 13 SimplePractice tools, never the cookie.
  • What the session sees. Whatever your own login sees, so use a team login with only the access the agent needs.
  • What no tool touches. Progress notes, treatment plans, diagnoses, payment cards and settings.
  • Two-factor codes. SimplePractice asks for a code at sign-in. You type it, we never do.
  • How to cut access. Disable for agents, reset the browser, or sign out in SimplePractice.

Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Approvals, undo and mistakes

  1. Reads the request. Time, service, source, and whether the person is a new client.
  2. Checks your calendar. The requested slot against what is already booked.
  3. Waits for your OK. Accept and the intake packet show up in your Cotlet console first.
  4. Reports back. Appointment ID, start time, documents shared and email sent.
ActionUndo
Accept a requestCancel the appointment; the confirmation email is already out
Decline a requestNone: a new client is archived and emailed
Set No show or Late canceledDelete the invoice, then set Canceled; an AutoPay charge needs a refund
Share intake documentsNone: the email and portal access are out
Send a Secure MessageNone: the client gets an email at once

6 of 13 tools ask first: every write, because each one emails a client or can charge one. The 7 reads run at once. Switch the wait off per tool for a scheduled run.

An insurance client marked No show or Late canceled owes the full fee, and setting Show again does not undo that. Ask the agent to list first and change statuses after you look.

MCP call:

{
  "name": "accept_appointment_request",
  "arguments": {
    "request_id": "rq_8810",
    "documents": [
      "Intake packet"
    ],
    "message": "Looking forward to meeting you on Thursday."
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/simplepractice/requests/rq_8810/appointment-request/accept \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"documents":["Intake packet"],"message":"Looking forward to meeting you on Thursday."}'

Tool output:

{
  "request_id": "rq_8810",
  "status": "accepted",
  "appointment_id": "ap_5040",
  "client_id": "cl_3188",
  "start": "2026-10-29T15:00:00-07:00",
  "documents_shared": [
    "Intake packet"
  ],
  "email_sent": true
}

Scripts, cron jobs and n8n steps reach the same tools over REST at /api/v1/simplepractice, with the same key and price. A login without billing access gets an error on the billing tools, and a failed call is free. The tools table lists each REST path.

How much does the SimplePractice MCP server cost?

About $14 a month for a solo clinician with 20 sessions a week, 2,460 credits. Your SimplePractice plan stays billed by SimplePractice.

JobCallsCredits
Check the Requests page, daily1 × 30300
Accept a request and send intake2 × 8160
Review yesterday's sessions, workdays1 × 22220
Mark a no-show or late cancel1 × 440
Denied and rejected claims, weekly3 × 4120
Overdue balances and reminders, weekly3 × 4120
Cloud Browser, 30 days1,500
Total2,460
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Works on Starter, Essential and Plus

SimplePractice's own rate guide works with 20 clients a week. The counts of requests and no-shows are our example. Dollars at the $29 pack rate.

SimplePractice MCP server on GitHub, hosted or by hand: which to use

OptionWhat it doesWhere it stops
chrischall/simplepractice-mcpReads a client's own Client Portal: appointments, billing items, documents. MIT, last push 26 Oct 2026.Client side only and read-only. Runs on your computer.
SimpleConnectSimplePractice's scheduling API for health plans and EAPs.Not open to practices.
Unified API vendorsSome sell a SimplePractice API built from the web app.Aimed at software companies, not one practice.
Zapier, n8n, MakeNo SimplePractice app on Zapier or n8n (checked 27 Oct 2026).Workflows run on calendar sync and email alerts, not the account.
By handRequests, Share, Billing and Analytics > Reports in the web app.Free, but it is your evening.

No free server works on the clinician account today. Cotlet is for a practice owner who wants requests, intake and claim follow-up handled from Claude or ChatGPT with each client-facing step approved.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), working since 2019, founded by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the SimplePractice tools go to contact@cotlet.dev.

SimplePractice API and MCP: questions

Can I use the SimplePractice API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.

How do I get access?

Create a free account at https://cotlet.dev, open SimplePractice under Integrations in the console and sign in to SimplePractice in its Cloud Browser. The trial starts when you sign up, no card asked.

How do I connect SimplePractice to ChatGPT or Claude?

Sign up at cotlet.dev, log in to SimplePractice once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your SimplePractice account through Cotlet, in their phone apps too.

What can ChatGPT do in SimplePractice?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in SimplePractice: triage new appointment requests; mark no-shows and late cancels; follow up on denied and rejected claims. You ask in plain words, and anything that reaches other people waits for your OK first.

Can the agent read progress notes?

No. No tool reads, exports or writes progress notes or other clinical documents. The tools cover the calendar, requests, intake sharing, billing, claims and Secure Messaging.

Does SimplePractice two-factor authentication still work?

Yes. SimplePractice requires two-factor authentication for new customers since 1 Oct 2026 (help center, checked 27 Oct 2026). You enter the code yourself when you sign in to your Cloud Browser; Cotlet never bypasses it.

Can a team member's login be used?

Yes. SimplePractice gives each team member their own login and two-factor setup. The agent sees what that login sees, so a login without billing access cannot read balances or claims.

Can the agent fix and resubmit a denied claim?

No. get_claim returns the payer's remarks; the corrected claim is filed in SimplePractice by you.

Is the MCP server different from the REST API?

Only the door is different. Both expose the same 13 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with SimplePractice?

No. Cotlet is independent and not affiliated with SimplePractice, LLC.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.