# Beadhive

> Beadhive is an open-source MCP server for developer tools. Run cross-repository beads work and hive status for agent-driven engineering. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://beadhive.ai
- **Repository:** https://github.com/beadhive/beadhive
- **MCP Registry name:** io.github.beadhive/beadhive
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

Beadhive's bh command is the front end of a software factory that tracks work as beads: each repository is its own issue database (a hive) with a short stable prefix, and bh onboards them, keeps labels consistent and aggregates every hive into one cross-repo view. This MCP server, bh-mcp, exposes that to agents.

Issue data lives in each repo's own Dolt database under refs/dolt/data on its git remote, with config under ~/.beadhive/. The project describes seats such as planner, dispatcher, developer, reviewer, merger and warden, which a person or an agent can fill, and human-held gates that block a merge while open. Validation results are tied to the exact tree they ran on.

It is a thin orchestrator over bd, git, git-workspace, dolt and docker, and the recommended install uses Nix. The site says nothing is hosted and the repo is untouched until you ask.

## Features

- **Cross-repo view:** Aggregate many repositories' issue databases into one.
- **Seats and gates:** Planner to warden roles, with merge blocked while a gate is open.
- **Dependency graph:** A git-embedded tracker computes what to do next.
- **Per-agent identity:** Each agent works in its own worktree under its own identity.
- **Proven validation:** Results are keyed to the exact tree they ran on.
- **Local only:** No signup or hosted dependency.

## Good for

- See issue status across several repositories at once
- Let agents plan, review and merge with human gates
- Onboard a new repo into a shared label scheme
- Gate releases on attested validation

## Install

### Claude Code (Terminal)

```sh
claude mcp add beadhive -- uvx beadhive
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### Is anything hosted?

The site says no signup and no hosted dependency; everything runs on your machine.

### Where is issue data stored?

In each repo's own Dolt database on its git remote, not in ~/.beadhive/.

### What does it depend on?

bd, dolt, gh, git-workspace and git; the managed install pins them with Nix.

### Is it open source?

The site describes it as open source.

### Is Beadhive free?

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

### How do I add Beadhive to Claude Code?

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

### What are the best alternatives to Beadhive?

The closest alternatives to Beadhive 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

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