# cabildo

> cabildo is an open-source MCP server for developer tools. Messaging and advisory locks so several Claude Code sessions can share one repository. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS
- **Website:** https://cardona-oss.gitlab.io/cabildo/
- **Repository:** https://github.com/jorgeecardona/cabildo
- **MCP Registry name:** io.github.jorgeecardona/cabildo
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add cabildo -- uvx cabildo
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cabildo": {
      "command": "uvx",
      "args": [
        "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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/cabildo
