Phone-a-Friend

Enables real-time, session-based communication between Claude Code instances for listener/caller interactions.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "taylorsatula-phone-a-friend-mcp": {
      "command": "python",
      "args": [
        "-m",
        "phone_a_friend.server"
      ]
    }
  }
}

Phone-a-Friend MCP lets Claude Code instances collaborate in real time by designating one instance as a listener and another as a caller. It creates a dedicated TCP hub for session-based questions and answers, enabling quick, structured conversations between your Claude tabs.

How to use

Start a listening session in one Claude tab and use another tab to ask questions through a connected session.

Steps to use the server in practice:

One tab becomes the Listener and waits for questions.
Another tab acts as the Caller and sends questions with a defined intent.
The Listener answers, and the Caller can wait for the response before continuing.

How to install

cd ~/.claude/mcps/phone-a-friend
pip install -e .

Configuration and running

After installing, start the hub and configure your Claude Code client to connect to it.

# Start the hub
paf-hub

{
  "mcpServers": {
    "phone-a-friend": {
      "command": "python",
      "args": ["-m", "phone_a_friend.server"],
      "cwd": "/Users/YOUR_USERNAME/.claude/mcps/phone-a-friend/src"
    }
  }
}

Usage pattern in practice

With the hub running and the client configured, you can create a session where one Claude tab waits for questions, and another tab connects to that session to ask a question with a specified intent.

Tool reference

You have access to a single MCP tool named paf that manages real-time conversations between a Listener and a Caller.

Conversation flow example

Listener waits for questions, Caller connects and sends a question, Listener responds, Caller waits for the answer, and the Listener goes back to listening for more questions.

Available tools

paf

Single MCP tool with actions to manage Listener/Caller sessions, including listening, listing sessions, connecting, sending messages, waiting for responses, responding, and ending sessions.