Session Relay MCP Server

Let Claude Code sessions see each other, message each other and stay out of each other's way in git: on one machine right after installing the plugin, or across different machines with a small…

Remote serverstreamable-http

What is the Session Relay MCP Server?

claude-session-relay is an MCP project maintained in the dimitrihilverda/claude-session-relay repository. The maintainer describes its purpose as “Let Claude Code sessions see each other, message each other and stay out of each other's way in git: on one machine right after installing…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using php. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares RELAY_URL, RELAY_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the Session Relay MCP Server

{
  "mcpServers": {
    "session-relay": {
      "command": "php",
      "args": [
        "/path/to/claude-session-relay/server/bin/relay-mcp"
      ],
      "env": {
        "RELAY_URL": "https://relay.example.com",
        "RELAY_TOKEN": "YOUR_RELAY_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
RELAY_URLDeclared in the maintainer’s client configuration.Check documentation
RELAY_TOKENDeclared in the maintainer’s client configuration.Check documentation