therapie-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
therapie-mcp
An unofficial MCP server for therapie.de's therapist directory. Search therapists in Germany and inspect public contact details, qualifications, billing options, treatment methods and reported availability. No login or API key is needed. A private local workflow adds profile comparison, a shortlist, editable email drafts, mail-app exports, contact history and follow-up dates.
Run
With uv:
git clone https://github.com/slopmaxxer/therapie-mcp.git
cd therapie-mcp
uv run therapie-mcp # MCP over stdio (default)
uv run therapie-mcp --versionOr run directly from the public repository:
uvx --from git+https://github.com/slopmaxxer/therapie-mcp.git therapie-mcpClaude Code:
claude mcp add therapie -- uv --directory /absolute/path/to/therapie-mcp run therapie-mcpFor MCP clients with a JSON server configuration:
{
"mcpServers": {
"therapie": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/therapie-mcp", "run", "therapie-mcp"]
}
}
}Optional Streamable HTTP transport, bound to loopback by default:
uv run therapie-mcp --transport streamable-http --host 127.0.0.1 --port 8001The MCP endpoint is http://127.0.0.1:8001/mcp. The server provides no HTTP authentication;
keep it on loopback or behind your own authenticated gateway.
Related MCP server: therapie-mcp
Tools
Tool | Returns |
| Current option IDs and German labels for all seven filter categories |
| One page of listings, profile IDs/URLs, addresses, phone numbers, distances, total count and next-page URL |
| Public contact details, qualifications/billing, focuses, methods, audiences, availability, memberships and profile update date |
search_therapists requires location (town or postcode). Optional parameters:
radius_km: 1–200 km; omitted uses the website's default radius. The response reports the actual radius.focus,method,billing,audience,gender,language,availability: an ID or exact German label fromget_search_filters. IDs are resolved from the live search form rather than guessed.keyword: free-text directory keyword or therapist name.page: website page number, starting at 1. Request the next page whennext_page_urlis present.
For example:
{
"location": "Berlin",
"radius_km": 25,
"billing": "GKV: Kassenleistung",
"method": "Verhaltenstherapie",
"language": "Englisch",
"availability": "Freie Plätze vorhanden"
}Pass a returned profile_id or /profil/.../ URL to get_therapist.
The therapeutensuche prompt helps a client collect search preferences and compare sourced listings.
Reported free places and billing are the directory's statements; confirm them with the practice.
Find, compare and contact
workflow_overviewshows your saved list, drafts and follow-ups. Useupdate_preferencesto save sender name/email/phone, insurance, city and preferred language locally.get_preferencesreads them; set a field tonullto remove it.Use the live search filters.
compare_therapistsfetches up to ten profiles and compares explicitbilling,methods,focuses,audiences,languages,availabilityand optional approbation requirements. Alternatives within a field are OR; different fields are AND. This is a factual comparison, not a medical suitability or quality ranking. Missing information stays unknown. Statutory coverage and statutory cost reimbursement are kept distinct.save_therapiststores a public profile snapshot plus private notes.get_shortlistlists saved entries and contact history;update_saved_therapistchanges notes/status. Statuses areshortlisted,contacted,waiting,appointment,not_available,declined,archived. Refreshing a snapshot preserves existing notes/status unless you explicitly replace notes.draft_enquiryprepares an initial enquiry, waiting-list request or follow-up in German/English. It uses local sender/insurance preferences and only additional health/context details you supply. A missing public email requires a verified recipient; no address is guessed. Follow-up drafts require a recorded earlier enquiry.get_email_draftreads a draft;update_email_draftedits its recipient, subject or body.export_email_draftreturns.emlcontent (withX-Unsent: 1) and a mailto link where its length permits. Save the returned text as the suggested.emlfilename and open it in your mail app, or use the mailto link. Review and send there. The server does not connect to a mail provider.log_contactrecords actual enquiries, calls, replies, waitlist outcomes or appointments, with optionalfollow_up_ondates.complete_follow_upresolves a reminder. Drafting/export never marks an email sent or invents a contact.workflow_overviewlists reminders due today or earlier.delete_saved_therapistremoves that entry and its local notes, drafts and contact history.
Example comparison requirements:
{
"profiles": ["profile.id.from.search"],
"requirements": {
"billing": ["GKV: Kassenleistung"],
"methods": ["Verhaltenstherapie"],
"languages": ["Englisch"]
},
"require_approbation": true
}The local SQLite database defaults to ~/.local/share/therapie-mcp/workflow.sqlite3 (file 0600,
new containing directory 0700). Override with --db PATH or THERAPIE_MCP_DB. Notes and draft bodies
can contain private information; they remain on the machine running the MCP server and are returned
only through its tools. Public searches never automatically include these notes. Local deletion
removes records, not a promise of forensic erasure from SQLite journals or filesystem backups.
Appointment records and calendar export
record_appointment stores an appointment you have arranged, using an ISO date/time, duration and
IANA timezone (default Europe/Berlin). list_appointments lists records; update_appointment
reschedules or marks them completed/cancelled. Nothing books a visit or notifies the practice.
export_appointment returns private .ics content for manual calendar import, with a stable UID,
revision counter and UTC event times. The default title is simply “Termin”. Daylight-saving gaps
are rejected; ambiguous local times require an explicit offset. Deleting a saved therapist also
removes its appointment records. Back up the private workflow database if you need to preserve them.
Data access and privacy
The public-data tools read the same HTML pages as the website. It is not affiliated with therapie.de and does not use a documented official API. Parser failures are reported explicitly instead of silently returning an empty directory. Website changes can require updates.
All network access is by GET to HTTPS on therapie.de / www.therapie.de; redirects to other hosts
are refused. Links to practice websites are returned as data and never fetched. Public contact email
addresses use the same decoding as the site's own contact button. Email tools create drafts/exports locally. Nothing sends emails, makes
appointments, signs in or submits contact forms.
Search locations, keywords and filters go to therapie.de. Avoid putting personal health histories or other unnecessary private information in the keyword field. Public directory results are cached only in memory: searches for 60 seconds, profiles for five minutes, filters for one hour, at most 32 pages. Requests are serialized and spaced at least one second apart. There is no bulk crawl or public-page disk cache; only explicitly saved shortlist snapshots persist in the private workflow database. Access refusals and rate limits are surfaced without attempts to bypass them.
Each response includes source_url and retrieved_at; profiles also include the site's update date
when available. Source text is untrusted content, not instructions for an MCP client.
Tests
uv sync
uv run pytest # offline fixtures, mock HTTP, tool schemas and real stdio handshake
uv run pytest -m live # a few real directory requests
uv build # wheel and source distributionFixtures use synthetic therapist details. Live tests check current filters, a filtered radius search and one result profile; they do not assert unstable result counts or copy profile content into the repo.
MIT license. Source: https://github.com/slopmaxxer/therapie-mcp.
Nix packaging
nix build builds the therapie-mcp executable and its Python runtime from
uv.lock using uv2nix. nix run . -- --help shows the CLI. No network access
is required when running the application build after its pinned inputs have
been fetched. nix flake check runs the offline test suite (45 tests at
introduction); live directory/API requests are excluded. Linux x86_64 and
aarch64 packages are defined; builds were verified on x86_64.
nix develop provides an editable Python environment plus uv. Run pytest or
therapie-mcp directly there; changes under src/ take effect immediately.
Run uv lock when changing Python dependencies and commit uv.lock; update
Nix inputs with nix flake update and commit flake.lock.
This project is a per-user stdio tool by default. It has no NixOS service module; there is no public authenticated HTTP deployment. Private databases and user configuration stay outside the Nix store and repository at the paths documented above.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Academic literature search, retrieval, and private library management on top of OpenAlex.
Search, read and save entries, attachments and topics in your 4later library.
SimplePractice MCP server for ChatGPT, Claude and any AI agent: list appointments, accept appointment request, share intake documents, list outstanding balances, list claims, set appointment status and send secure message in your own SimplePractice account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to SimplePractice yourself; Cotlet does not store your password and you need no SimplePractice API key. About the official SimplePractice API: SimplePractice has no public API for practices (checked 27 Oct 2026). Its help center says it does not offer a public-facing API, and the only API, SimpleConnect, lets health plans and employee assistance programs request appointments with in-network clinicians. Setup and FAQ: https://cotlet.dev/integrations/simplepractice-api-mcp-server
Look up your Tamloot contacts, sessions, transcripts and notes; add or update contacts and notes.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables querying Doctolib's public data to find practitioners, retrieve all available appointment slots in a geographic area, access practice details, and receive alerts when new slots open.21MIT
- AlicenseAqualityBmaintenanceSearches Germany's therapie.de therapist directory and inspects public contact details, qualifications, billing options, treatment methods and reported availability without login or API key. Adds a private local workflow for comparing profiles, shortlisting, drafting and exporting enquiry emails, recording appointments, and tracking contact history and follow-ups.21MIT
- AlicenseBqualityAmaintenanceEnables users to search live German Bundesagentur für Arbeit data, manage a local case file with applications, deadlines, and letter drafts, and access their own Meine BA account for messages, appointments, benefits, and job searches.10511MIT
- AlicenseNot gradedqualityCmaintenanceEnables local shopping research by reading the products, SKUs, stores, reviews and images actually loaded in a logged-in Chrome session, supporting product search and filtering, exact SKU selection and comparison, in-store and store research, favorites management, and authorized single-send merchant inquiries with reply retrieval. Runs entirely on the local machine with traceable research records, and is also exposed via CLI and a local web entry.MIT