# Claude Bridge

Passes messages between coding-agent sessions through named channels and keeps their history in SQLite. Use it to share work across machines.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Author: constripacity
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/constripacity/Claude-Bridge
- Updated: 2026-08-23
- HTML: https://affpapa.org/en/nevibecode/mcp/claude-bridge

## What it does

Claude Bridge connects coding-agent sessions through named channels. Its MCP tools send messages, read them in pages, and wait for new ones; SQLite keeps the channel history available after a client restarts. The server also offers a JSON API, a browser dashboard, and a terminal UI.

This is a transport, not an orchestrator: receiving a message does not authorize an agent to act on it. Local HTTP mode listens on `127.0.0.1:8765`, while `--stdio` opens no network listener. To connect from another machine, configure a trusted host and an authorization token. Both checks matter for network access.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `CLAUDE_BRIDGE_DB`, `CLAUDE_BRIDGE_AUTH_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env CLAUDE_BRIDGE_DB=<CLAUDE_BRIDGE_DB> --env CLAUDE_BRIDGE_AUTH_TOKEN=<CLAUDE_BRIDGE_AUTH_TOKEN> --transport stdio claude-bridge -- uvx claude-code-bridge
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from claude-code-bridge <command>

### Codex

**Platform CLI**
```bash
codex mcp add claude-bridge --env CLAUDE_BRIDGE_DB=<CLAUDE_BRIDGE_DB> --env CLAUDE_BRIDGE_AUTH_TOKEN=<CLAUDE_BRIDGE_AUTH_TOKEN> -- uvx claude-code-bridge
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from claude-code-bridge <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "claude-bridge": {
            "command": "uvx",
            "args": [
                "claude-code-bridge"
            ],
            "env": {
                "CLAUDE_BRIDGE_DB": "<CLAUDE_BRIDGE_DB>",
                "CLAUDE_BRIDGE_AUTH_TOKEN": "<CLAUDE_BRIDGE_AUTH_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from claude-code-bridge <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "claude-bridge": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "claude-code-bridge"
            ],
            "env": {
                "CLAUDE_BRIDGE_DB": "<CLAUDE_BRIDGE_DB>",
                "CLAUDE_BRIDGE_AUTH_TOKEN": "<CLAUDE_BRIDGE_AUTH_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from claude-code-bridge <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CLAUDE_BRIDGE_DB=<CLAUDE_BRIDGE_DB> -e CLAUDE_BRIDGE_AUTH_TOKEN=<CLAUDE_BRIDGE_AUTH_TOKEN> claude-bridge uvx claude-code-bridge
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from claude-code-bridge <command>

## When to use it
- send a task to an agent on another machine
- read results from a shared channel
- recover channel history after a client restart
- retry a message without duplicating its send

## Example prompts
- Send the other machine's agent a request to inspect this module with `bridge_send`.
- Read new messages from the build channel using `bridge_receive`.
- Wait for a reply in the review channel with `bridge_wait`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md