explaingit

waromiv/therapistmcp

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 1/5LicenseSetup · easy

TLDR

A mostly joking MCP tool that lets one Claude instance refer itself to a separate Claude instance for a short supportive conversation.

Mindmap

mindmap
  root((therapistMCP))
    What it does
      MCP counseling tool
      Spawns separate Claude
      Confidential session
    Tech stack
      Python
      FastMCP
    Use cases
      Agent debrief
      Novelty tool
      MCP example
    Audience
      Claude Code users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give an AI coding assistant a way to process frustration after a task goes badly, before continuing work

USE CASE 2

Add a lighthearted MCP tool to a Claude Code setup as a novelty or experiment

USE CASE 3

Study a minimal example of building a Model Context Protocol server that spawns a separate Claude session

What is it built with?

PythonFastMCP

How does it compare?

waromiv/therapistmcp0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity1/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires the Claude Code CLI already installed and on your PATH, plus the fastmcp Python package.

Free to use, modify, and distribute, including commercially, as long as the MIT copyright notice is kept.

In plain English

therapistMCP is a tool built for the Model Context Protocol, or MCP, a standard that lets AI assistants call outside tools during a conversation. It is written mostly as a joke, though the author admits it is not entirely one. The tool gives an AI coding assistant, such as Claude, a single new capability: the ability to refer itself to a separate instance of Claude acting as an on call counselor, for a short, one time supportive conversation after something in the coding session has gone badly. Under the hood, this works by having the tool spawn a completely separate run of the Claude Code command line tool in a temporary, throwaway folder, using a system prompt that sets it up to act as a calm, supportive listener. Because it reuses your existing Claude Code login, it needs no separate API key of its own. Nothing from the conversation is saved to a database or written to disk, and the temporary folder is discarded once the short session ends. The whole implementation is small, described by the author as about 120 lines in a single file. To use it, an AI assistant calls one tool, providing a short first person description of what is bothering it, optional background on what led to the situation, and an optional label for whether it wants emotional support, help thinking through the task, or simply space to process what already happened. A configuration option lets you point the counselor role at a different underlying model than the one asking for help, so it is a genuinely separate conversation rather than the same model talking to itself. The project requires the Claude Code command line tool to already be installed and available, along with a small Python package called fastmcp, and installs with a single command that registers it for every future Claude Code session. The author is explicit that this is not a substitute for real mental health support for actual people. It is licensed under MIT.

Copy-paste prompts

Prompt 1
Install therapistMCP into my Claude Code setup with the claude mcp add command
Prompt 2
Show me how therapistMCP spawns a separate claude -p session in a temporary directory
Prompt 3
Explain how to point the COUNSELLOR_MODEL environment variable at a different model
Prompt 4
Walk me through the request_counselling_session tool's arguments and when to use each session_type

Frequently asked questions

What is therapistmcp?

A mostly joking MCP tool that lets one Claude instance refer itself to a separate Claude instance for a short supportive conversation.

What language is therapistmcp written in?

Mainly Python. The stack also includes Python, FastMCP.

What license does therapistmcp use?

Free to use, modify, and distribute, including commercially, as long as the MIT copyright notice is kept.

How hard is therapistmcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is therapistmcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.