Skip to content
MCP server

cabildo

Messaging and advisory locks so several Claude Code sessions can share one repository

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.1.185
Listing updated
2 days ago

About cabildo

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

cabildo works as a shared chat room and message bus for Claude Code agents running at once. Sessions can message each other directly or by topic, see who else is active, and take advisory locks before shared actions such as committing and pushing. The name comes from the Spanish term for a town council.

It ships as a Python package with one stdio MCP server plus hook scripts that handle message delivery, liveness and lock enforcement. All state lives in a single SQLite database shared by every session, so there is no daemon and nothing touches the network: agents that share a filesystem share a bus.

Two commands let you watch the traffic. cabildo watch opens a full-screen chat room in the terminal and cabildo viewer serves a read-only web view on localhost port 8787. The project README also covers identity, a git guard, a push daemon and an issues register.

Install

Run in a terminal

claude mcp add cabildo -- uvx cabildo

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cabildo": {
      "command": "uvx",
      "args": [
        "cabildo"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cabildo": {
      "command": "uvx",
      "args": [
        "cabildo"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "cabildo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cabildo"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "cabildo": {
      "command": "uvx",
      "args": [
        "cabildo"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "cabildo": {
      "command": "uvx",
      "args": [
        "cabildo"
      ]
    }
  }
}

What it does

Direct and topic messages
Agents message one another directly or subscribe by topic.
Presence discovery
An agent can see which other sessions are working.
Advisory locks
Sessions take locks to coordinate commits and pushes.
Hook scripts
Hooks handle delivery, liveness and lock enforcement.
Single SQLite store
All state is one local database, with no daemon or network.
Terminal and web viewers
cabildo watch and cabildo viewer show the bus live.

Good for

  • Stop two agents from pushing to the same branch at once
  • Let parallel Claude Code sessions hand off work to each other
  • Watch what several agents are saying while they work
  • Coordinate commits across sessions in one repository

Pricing

Open source

Free Python package

Prices change. Check cardona-oss.gitlab.io before you buy.

cabildo FAQ

How do I install it?

Run pip install cabildo or uv tool install cabildo, then claude mcp add --scope user cabildo -- cabildo-mcp.

Does it need a server?

No daemon is required and nothing touches the network; it relies on a shared SQLite database.

Can I see the messages?

Yes, with cabildo watch in a terminal or cabildo viewer for a read-only web page on 127.0.0.1:8787.

Is cabildo free?

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

How do I add cabildo to Claude Code?

Run this command in your terminal: claude mcp add cabildo -- uvx cabildo

What are the best alternatives to cabildo?

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

Alternatives to cabildo

  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