Session Relay — Claude Code MCP server: share coding sessions
Session Relay hands off a coding session from one developer to another: goal, decisions, next steps and conversation history. A teammate runs /pickup in their agent and continues.
AGPL-3.0 ★ 9 updated 2026-10-26
claude mcp add --env RELAY_SERVER=<RELAY_SERVER> --env RELAY_TOKEN=<RELAY_TOKEN> --transport stdio cli -- npx -y session-relayWhat Session Relay does
One person runs /share, another runs /pickup in their agent and gets the context: what was done, what was decided, what comes next. You can hand off to a specific teammate (/share for bob), attach uncommitted changes (--diff), or link a pull request. The /live command shows who is working on what and lets you send a message to a teammate's session — it reaches their agent between steps.
You need to deploy a Session Relay server for your team; the docs cover self-hosting. Cloud hosting is not yet available. Prompts and secrets (API keys, tokens, passwords) are filtered locally before upload; relay share --dry-run shows what would be sent. The relay setup command connects the MCP server to every installed agent.
What it helps with
- hand off an unfinished task to a teammate with full context
- pick up where another developer left off
- see who on the team is working on what right now
- send a message into a teammate's agent session
- preserve session history for the team
Example prompts for the agent
- Share this session with Alice and attach my uncommitted changes
- Pick up Bob's last session on webhook retries
- Show me who's working now and on which files
How to install Session Relay
Platform CLI
claude mcp add --env RELAY_SERVER=<RELAY_SERVER> --env RELAY_TOKEN=<RELAY_TOKEN> --transport stdio cli -- npx -y session-relayReplace <…> with your own values
Platform CLI
codex mcp add cli --env RELAY_SERVER=<RELAY_SERVER> --env RELAY_TOKEN=<RELAY_TOKEN> -- npx -y session-relayReplace <…> with your own values
Config file
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"session-relay"
],
"env": {
"RELAY_SERVER": "<RELAY_SERVER>",
"RELAY_TOKEN": "<RELAY_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"session-relay"
],
"env": {
"RELAY_SERVER": "<RELAY_SERVER>",
"RELAY_TOKEN": "<RELAY_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e RELAY_SERVER=<RELAY_SERVER> -e RELAY_TOKEN=<RELAY_TOKEN> cli npx -y session-relayReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Session Relay
How to install Session Relay in Claude Code?
Run claude mcp add session-relay -e RELAY_TOKEN=<RELAY_TOKEN> -- npx -y session-relay, substituting your server's token.
What does Session Relay do?
It hands off a coding session to another person: goal, decisions, next steps and conversation history. A teammate runs /pickup in their agent and continues from the same point.
Do I need my own server to use Session Relay?
Yes, you need to deploy a Session Relay server for your team. Cloud hosting is not yet available.