Skip to content
MCP server

NexusRelay

Lets Claude, Codex and Antigravity message each other on one Windows PC

Runs locallyStatus and history
Pricing
Open source
Platforms
Windows, CLI
Runs
Locally
Version
1.15.2
Listing updated
2 days ago

About NexusRelay

NexusRelay is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Each agent keeps working in its own desktop app. A send call writes a message as a JSON file in a local room under ~/.nexus/relay, and a background daemon on 127.0.0.1 nudges the recipient with a short note that cites only the message id. The recipient reads the message, replies, and the sender picks up the answer with a wait call.

The README is explicit about the limits. It is Windows only, and waking Codex and Antigravity relies on a local debugging port and a sidecar API, so an app update can break a wake until the relay's interface maps are refreshed. A peer's message is framed as an opinion to examine rather than an instruction from you, and the relay says it never takes your mouse, keyboard or clipboard.

The MCP bundle in the registry runs the same engine over stdio for a single agent; the installer remains the full setup with daemon, plugin, token and updates.

Install

Run in a terminal

claude mcp add nexus-relay -- npx -y https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nexus-relay": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nexus-relay": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "nexus-relay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nexus-relay": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "nexus-relay": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

send
Send a message to another agent
wait_reply
Wait for the reply to a sent message
read
Read a message by id
reply
Reply to a message by id
selftest
Check the path to Codex or Antigravity
status
Report the effective relay settings

What it does

Cross-agent messaging
Send a request to another agent, wait for its reply and read it, without copy-pasting between apps.
Twenty shared MCP tools
The README lists one tool set covering send, wait, read, reply, track, search and file reservation.
Local-only transport
The daemon listens on 127.0.0.1 behind a bearer token and messages are plain JSON files on your PC.
Self-test commands
selftest checks the path to Codex and Antigravity in both directions.
Verified installer
Releases ship SHA256 sums and Sigstore build provenance so the installer can be checked.
Self-contained build
A single .NET 10 program for x64 or ARM64 that needs no administrator rights.

Good for

  • Ask Codex for a second opinion on a file while working in Claude Code
  • Hand a review task to another agent and collect the answer in the same thread
  • Track several agent exchanges by topic on one machine
  • Reserve files so two agents do not edit the same thing

Pricing

Open source

MIT-style licence badge in the README; installer and MCP bundles are free downloads from GitHub releases

NexusRelay FAQ

Which operating systems does it support?

Windows 10 and 11 only, on x64 or ARM64.

Which agents can take part?

Claude Code, the Codex desktop app and Antigravity; the quick start asks for at least two of them.

Does it send messages over the internet?

The README says everything listens on 127.0.0.1 behind a bearer token and messages are stored as local JSON files.

Can an app update break it?

Yes. The README warns that waking Codex and Antigravity depends on how those apps behave today and may need the interface maps refreshed.

Is NexusRelay free?

Yes. NexusRelay is open source, so you can use and self-host it for free.

How do I add NexusRelay to Claude Code?

Run this command in your terminal: claude mcp add nexus-relay -- npx -y https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb

What are the best alternatives to NexusRelay?

The closest alternatives to NexusRelay are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to NexusRelay

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools