Practice Better in ChatGPT and Claude: practitioner guide

This connector lets you talk to your Practice Better account from ChatGPT or Claude: look up clients, check the calendar, book and cancel sessions, review intake forms, read clinical data, pull billing reports and more. Everything runs against your live account with your own API key, so treat it like the Practice Better app itself.

Before you connect

1. Enable the API add-on. In Practice Better open your profile menu → My Subscription → View add-ons → API Access (Beta). Practice Better support approves the request; wait for that.
2. Create a key for this connector only. Settings & Preferences → API Access → Create key. Name it (for example "ChatGPT connector"), choose read or read-and-write access, and do not set an IP allowlist: the connector runs on a global edge network and an allowlist will block it. Copy the Client ID and Client Secret; the secret is shown once.
3. Add the connector.

• ChatGPT: Settings → Apps & Connectors (or Plugins) → Advanced settings → enable Developer mode → Create. Name it "Practice Better", MCP server URL https://mcp.ishysing.is/practicebetter/mcp, authentication OAuth.
• Claude: Settings → Connectors → Add custom connector with the same URL.
• Claude Code: claude mcp add --transport http practicebetter https://mcp.ishysing.is/practicebetter/mcp, then /mcp to sign in.

1. Sign in. The app opens https://mcp.ishysing.is/authorize. Paste the Client ID and Secret, choose read-and-write or read-only, tick the consent box and continue. Nothing else ever asks for these values.
2. Check the connection. Ask: "Who am I connected as?" and confirm it names you.

How to ask

Talk naturally. The assistant picks the right tool; you do not need tool names. Useful habits:

• Name the client the way you would say it. Icelandic letters and accents are optional and word order does not matter: "Jón Sigurðsson", "jon sigurdsson" and "Sigurðsson Jón" all work, as do an email address or phone number.
• Give dates and times explicitly ("next Tuesday at 10", "between 1 and 15 October"). Times are interpreted in your practice time zone.
• Say whether the client should be notified. For bookings, cancellations and invitations the assistant must be told whether Practice Better should email the client. If you do not say, it will ask.
• Confirm before changes. The assistant always describes a change before making it. Irreversible actions (delete, cancel, send a form, webhooks) are previewed first and only executed after you approve.

What you can do, with example prompts

Calendar and availability

• "What is on my schedule tomorrow?" / "List this week's sessions with Anna."
• "When am I free for a 60-minute initial consultation next week?"
• "Book Anna Jónsdóttir for a follow-up on Thursday at 14:00, virtual, and notify her."
• "Move Friday's 9:00 session to 11:00." / "Cancel Monday's session with Guðrún and send her the cancellation email."

Clients

• "Find the client with email …" / "Show me Ólafur's record."
• "Create a new client: Sigríður Einarsdóttir, sigga@example.is, mobile 555 0000, and send her the portal invitation."
• "Mark Jón as inactive." / "Tag Anna with 'Postpartum'."
• "Which clients were added in the last 30 days?"

Intake forms and questionnaires

• "Which forms has Anna completed?" / "Show her intake answers."
• "Send the Initial Intake form to Ólafur." (previewed, then sent by email)

Clinical data

• "Summarise Anna's medical history and current medications."
• "What are Jón's latest blood results?" / "Log a weight of 78 kg for Anna today." (converted to pounds automatically)
• "List Guðrún's active protocols" / "Give me a PDF link to her latest protocol."
• "Show the session notes from her last visit." (notes are read-only via the API)
• "Any lab requests still pending?"

Billing and insurance

• "List unpaid invoices from last month." / "Show invoice 1234."
• "Payment history for Q3 grouped by month, in ISK."
• "Sales tax summary for 2026 so far." / "Insurance claims report for August."
• "List Anna's superbills." (invoices and payments cannot be created via the API)

Packages and programs

• "Which packages does Anna have and when do they expire?"
• "Assign the 6-session package to Ólafur." / "Enroll these three clients in the Spring programme."

Practice settings, team and automation

• "What are my booking settings?" / "Who is on my team?"
• "Which webhook events are available?" / "Create a webhook to https://… for client.record.created." (two-step)
• "What time zone name should I use for Reykjavik?"

Safety notes

• No sandbox. Every change is made in your live account immediately. Prefer read-only access for exploration and reconnect with write access when you need it.
• Notifications are explicit. The assistant never emails a client unless you asked for it.
• Two-step confirmation protects deletes, cancellations, form sends and webhook changes.
• Rate limits. Practice Better allows 5 requests per second and 10,000 per day per key. Very broad questions ("list every client ever") are paged; the assistant will tell you when it stopped early.
• Reconnect every 90 days. Connections expire after 90 days; the assistant will say when it is time. Rotate the key in Practice Better at the same time.
• If you suspect the key is compromised: delete the key in Practice Better first (that instantly disables the connector), disconnect the connector in the app, then create a new key and reconnect.

What the API cannot do

Practice Better's API does not support secure messaging, uploading documents, creating or paying invoices, writing session notes, creating tasks/reminders, answering forms on a client's behalf, or group session management. The assistant will tell you when a request falls outside the API.

Troubleshooting

• "Credentials rejected": the key was deleted, the secret is wrong, the API add-on is not active, or the key has an IP allowlist. Create a fresh key and reconnect.
• "Read-only connection": reconnect and choose read and write (the key in Practice Better must allow write access too).
• "Rate limited": wait a few seconds; ask narrower questions.
• Name not found: try the email address or part of the surname; prospects with status pendingcreate are included.
• Times look off: check the time zone in "Who am I connected as?" and state times explicitly.