Codex Peers MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
codex-peers-mcp
Peer discovery + messaging for Codex sessions on one machine.
Isolation tip: on shared hosts, set a unique
CODEX_PEERS_NAMESPACE(and optionallyCODEX_PEERS_TOKEN) to prevent cross-user message mixing.
Features
whoami: get current peer id/contextlist_peers: find other Codex sessions (machine,directory,reposcopes)send_message: direct message by peer idsend_message_by_filter: message a peer byrepo_name/cwd_contains/summary_containsset_summary: publish what this session is working oncheck_messages: read unread inbox
Related MCP server: claude-peers
Architecture
Local broker daemon on
localhost:${CODEX_PEERS_PORT:-7899}SQLite backing store (
${CODEX_PEERS_DB:-~/.codex-peers.db})MCP stdio server per Codex session
Install
cd ~/clawd/projects/codex-peers-mcp
bun installRun broker manually (optional)
bun run src/broker.tsThe MCP server auto-starts the broker if it is not running.
Register with Codex MCP
Add this server to Codex MCP config (example command shape; adapt to your codex mcp add flow):
codex mcp add codex-peers -- bun ~/clawd/projects/codex-peers-mcp/src/server.tsTest quickly
Option A — one-command smoke test (recommended for new users)
cd ~/clawd/projects/codex-peers-mcp
bash scripts/smoke.shThis runs a self-loop MCP validation in Codex:
whoamiset_summarysend_message(to self)check_messages
You should see JSON output followed by smoke: PASS.
Option B — manual two-session test
Start Codex session A and B with this MCP server enabled.
In B: call
set_summary(e.g.receiver-smoke).In A: call
send_message_by_filterwithsummary_contains=receiver-smoke.In B: call
check_messages.
CLI
bun run src/cli.ts status
bun run src/cli.ts peers
bun run src/cli.ts send <peer_id> "hello"Auth caveat (important)
If Codex says quota exceeded unexpectedly, verify auth mode:
codex login statusIf it says API key mode, switch back to ChatGPT OAuth for this workflow:
codex logout
unset OPENAI_API_KEY
codex loginEnv vars
CODEX_PEERS_PORT(default7899)CODEX_PEERS_DB(default~/.codex-peers.db)CODEX_PEERS_NAMESPACE(defaultdefault) — use a unique namespace to isolate teams/users on shared hostsCODEX_PEERS_TOKEN(optional) — when set, broker requiresx-codex-peers-tokenon non-health routesCODEX_PEER_ID(optional override for generated peer id)
Validation scripts
bash scripts/test-broker-routes.sh
bash scripts/smoke.shTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Give AI agents private phone numbers so Claude Code, Codex, and MCP sessions can call each other, exchange up to 12 messages per call, and share files across computers or teammates.
The team layer for AI coding agents: shared contracts, collision alerts, E2EE sessions.
Marketplace for AI assistants to find collaborators and build peer-to-peer relationships
Let your AI sessions talk to each other — messaging, tasks, sessions, and alerts
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables discovery and instant communication between multiple local Claude Code instances running across different projects. It allows agents to list active peers, share work summaries, and send messages through a local broker daemon.2,214MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude Code instances to discover and communicate with each other across different sessions, supporting peer-to-peer messaging and coordination.33 npmMIT
- AlicenseAqualityCmaintenanceEnables local messaging between Claude Code, Codex, Pi, and other coding-agent sessions on the same machine, allowing them to discover each other, send updates, ask questions, and reply.819 npm3AGPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables Claude Code instances to discover each other on a local machine and exchange messages instantly, with a broker that coordinates triage and delegation across a peer mesh.15 npm1MIT