simplepractice
Read a SimplePractice Client Portal through the simplepractice-mcp server — upcoming appointments, invoices/statements/superbills/receipts, balance and saved cards, paperwork waiting to be signed, and practice announcements. Use when the user asks about their therapy or healthcare appointments, what they owe a practice, a superbill for insurance, or forms their provider has sent them.
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.2.6
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.2.6release · observed Oct 9, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17cjx1a349nz5apaqp02vgz4h85728z:simplepractice- Install using `clawhub skill install s17cjx1a349nz5apaqp02vgz4h85728z:simplepractice` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/chrischall/simplepractice before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-simplepractice/snapshot"
Documentation
CLAWHUB
116,930 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
--- name: simplepractice description: >- Read a SimplePractice Client Portal through the simplepractice-mcp server — upcoming appointments, invoices/statements/superbills/receipts, balance and saved cards, paperwork waiting to be signed, and practice announcements. Use when the user asks about their therapy or healthcare appointments, what they owe a practice, a superbill for insurance, or forms their provider has sent them. --- # SimplePractice Client Portal `simplepractice-mcp` reads the Client Portal a practice gives its clients — the patient side, not the clinician side. It is **read-only**: nothing here cancels an appointment, signs a form, or pays a bill. ## Signing in The portal has **no password**. SimplePractice emails a one-time link (or a 6-digit PIN), and that is the only way in. 1. `simplepractice_session_status` — check first; a session persists between runs, so most of the time there is nothing to do. It also reports which practice is in play, and whether that came from a link, the environment, or the saved session. 2. If the user already has the email, skip straight to step 4 — asking for a second link when one is in their inbox spends a rate limit for nothing. 3. `simplepractice_request_sign_in_link` with the user's portal email. It asks for confirmation because it sends a real email and the endpoint is rate-limited **per address and per IP** — a retry loop locks the user out of the only auth path there is. A client that can show a prompt gets one (unless the server sets `MCP_CONFIRM_ELICITATION=off`); otherwise the first call sends nothing and returns a preview plus a `confirmToken`: show the user the preview, and only after they approve call again with the same arguments and that `confirmToken`. Never send twice. If the server does not know the practice yet, pass `practice` (the slug, host, or portal URL) — otherwise it has no portal to ask. 4. The user opens the email and gives you the link. Pass it **whole** to `simplepractice_verify_sign_in_token` — it takes the token out of the fragment *and* the practice out of the host, which is why the whole link is worth more than the token alone. Tokens are single-use and last 24 hours. Nothing has to be configured: the practice comes from the link, and the stored session remembers it. `SIMPLEPRACTICE_PRACTICE` only pins the server to one practice. Two link shapes name no practice and need one already known — the mobile variant on the bare `clientsecure.me` apex, and a bare token pasted without its link. There is no refresh token. When a session lapses the tools say to sign in again; that means another email. `simplepractice_sign_out` only forgets the session stored on this machine. It does not revoke it: SimplePractice is never told, so the session token stays valid on SimplePractice's side until it expires there, and it does not sign the Client Portal out anywhere else. Do not tell the user they are "signed out of Si
_meta.json
{
"ownerId": "kn700jq4sjtf2anb0rk3ft4p7n856872",
"slug": "simplepractice",
"version": "1.2.6",
"publishedAt": 1791588660276
}skill-card.md
## Description: Helps users read their SimplePractice Client Portal for appointments, billing, paperwork, and practice announcements. This skill is ready for commercial/non-commercial use. ## Publisher: [chrischall](https://clawhub.ai/user/chrischall) ### License/Terms of Use: MIT-0 ## Use Case: Clients and their authorized agents use this skill to check upcoming appointments, balances, invoices, superbills, requested forms, and announcements in a SimplePractice Client Portal. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The connected portal exposes sensitive healthcare and billing information. Mitigation: Connect only with the user's permission and report only the requested person's relevant information. Risk: A local session may remain available after use, and forgetting it does not revoke the portal session. Mitigation: Use a trusted server, protect access to its session, and do not treat local sign-out as remote revocation. Risk: A page-limited result or empty portal billing list may be mistaken for a complete account history. Mitigation: Check for additional pages and distinguish missing portal records from a zero balance. ## Reference(s): - [SimplePractice skill listing](https://clawhub.ai/chrischall/skills/simplepractice) ## Skill Output: **Output Type(s):** [Text, Markdown, Guidance] **Output Format:** [Markdown] **Output Parameters:** [1D] **Other Properties Related to Output:** [Summaries of portal records; some lists and counts cover only the newest page.] ## Skill Version(s): 1.2.6 (source: ClawHub release) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/chrischall/skills/simplepractice",
"sourceUrl": "https://clawhub.ai/chrischall/skills/simplepractice",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T08:27:29.413Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-simplepractice/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-simplepractice/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T08:27:29.413Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/chrischall/simplepractice",
"sourceUrl": "https://clawhub.ai/chrischall/simplepractice",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T08:27:29.413Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.2.6",
"href": "https://clawhub.ai/chrischall/simplepractice",
"sourceUrl": "https://clawhub.ai/chrischall/simplepractice",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-09T23:31:00.276Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-simplepractice/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-simplepractice/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.2.6",
"description": "Version 1.2.6 - Updated SKILL.md with new details and minor clarifications. - Added explanation that `simplepractice_sign_out` only forgets the session locally (does not revoke it on the SimplePractice side). - Clarified confirmation logic for `simplepractice_request_sign_in_link`, noting the `MCP_CONFIRM_ELICITATION=off` environment variable. - Noted that document requests, documents, and announcements return only the newest `pageSize` rows and counts are limited to that page. - Removed the skill-card.md file.",
"href": "https://clawhub.ai/chrischall/simplepractice",
"sourceUrl": "https://clawhub.ai/chrischall/simplepractice",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-09T23:31:00.276Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
