xats: cross-agent inbox — Claude Code MCP server
xats: cross-agent inbox is an MCP server for Claude Code and Codex that connects sessions across vendors through a shared directory and mailbox. Messages travel locally between agents through a background daemon.
MIT ★ 7 updated 2026-11-15
claude mcp add --env XATS_MCP_URL=<XATS_MCP_URL> --env XATS_PORT=<XATS_PORT> --transport stdio xats-cross-agent-inbox -- npx -y xats-mcpWhat xats: cross-agent inbox does
The server links disparate agent environments like Claude Code, Codex, OpenCode, and Pi into a single local messaging bus. Every running session receives an address and a persistent inbox, retaining unread mail after a session ends.
A local background process in ~/.xats manages message routing across loopback. Running the daemon requires Node 20 or newer. Codex lacks native UI badges, so incoming messages arrive as developer context on the next model turn.
What it helps with
- exchange messages between Claude Code and Codex sessions
- retain agent addresses and unread queues across restarts
- coordinate multiple local assistant instances on one machine
- route local tasks between multi-vendor AI coding tools
Example prompts for the agent
- Check the xats inbox and summarize any unread messages.
- Send the failing test logs to the codex agent via xats.
- Claim the session name backend-worker using xats.
How to install xats: cross-agent inbox
Platform CLI
claude mcp add --env XATS_MCP_URL=<XATS_MCP_URL> --env XATS_PORT=<XATS_PORT> --transport stdio xats-cross-agent-inbox -- npx -y xats-mcpReplace <…> with your own values
Platform CLI
codex mcp add xats-cross-agent-inbox --env XATS_MCP_URL=<XATS_MCP_URL> --env XATS_PORT=<XATS_PORT> -- npx -y xats-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"xats-cross-agent-inbox": {
"command": "npx",
"args": [
"-y",
"xats-mcp"
],
"env": {
"XATS_MCP_URL": "<XATS_MCP_URL>",
"XATS_PORT": "<XATS_PORT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"xats-cross-agent-inbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"xats-mcp"
],
"env": {
"XATS_MCP_URL": "<XATS_MCP_URL>",
"XATS_PORT": "<XATS_PORT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e XATS_MCP_URL=<XATS_MCP_URL> -e XATS_PORT=<XATS_PORT> xats-cross-agent-inbox npx -y xats-mcpReplace <…> 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 xats: cross-agent inbox
How to install xats: cross-agent inbox in Claude Code?
Run claude mcp add xats -- npx -y xats-mcp. Make sure to initialize the background daemon first by executing npx xats-setup.
What does xats: cross-agent inbox do?
It provides a shared agent roster and mailbox system, letting assistants across different host environments exchange messages locally.
What is required to run xats: cross-agent inbox?
It requires Node 20 or higher alongside the local daemon configured via xats-setup.