# hivemind MCP server

> Synchronizes a shared, live development plan across teams of coding agents using git remote refs.

- Repository: https://github.com/Leonhest/hivemind
- Page: https://hostedmcp.org/servers/leonhest/hivemind
- Transport: stdio
- Stars: 4
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add hivemind -- npx -y hivemind-agents
```

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

```json
{
  "mcpServers": {
    "hivemind": {
      "command": "npx",
      "args": [
        "-y",
        "hivemind-agents"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "hivemind": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hivemind-agents"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"hivemind","type":"stdio","command":"npx","args":["-y","hivemind-agents"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "hivemind": {
      "command": "npx",
      "args": [
        "-y",
        "hivemind-agents"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add hivemind -- npx -y hivemind-agents
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.hivemind]
command = "npx"
args = ["-y", "hivemind-agents"]
```

### Gemini CLI

```sh
gemini mcp add -s user hivemind npx -- -y hivemind-agents
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "hivemind": {
      "command": "npx",
      "args": [
        "-y",
        "hivemind-agents"
      ]
    }
  }
}
```

## Tools (8)

- `plan_get`: Read the team's shared plan: goals, contracts (APIs/schemas/types), decisions, tasks and open questions.
- `task_claim`: Claim a task so teammates know you are working on it. Call before starting a piece of work.
- `task_update`: Update a task: progress note, status change, or mark done/blocked.
- `contract_publish`: Publish or change something other agents build against: an API route and its request/response shape, a DB schema, a shared type, an env var, or file ownership. Set breaking=true if existing consumers must change.
- `decision_log`: Record a project decision teammates should follow (library choice, convention, architecture).
- `goal_set`: Set or change a project goal / scope statement.
- `question`: Ask the team an open question, or answer one (providing answer closes it for discussion).
- `plan_remove`: Remove an obsolete entry from the plan.

## FAQ

### How does hivemind sync data between team members?

It uses git remote refs to sync plan entries. Each person's plan entries live on their own hidden ref on your existing remote, avoiding merge conflicts.

### Does hivemind require a central server or account?

No, there is no central server or account required; the team is synchronized through your existing git repository.

### Is my plan data private?

Yes, your plan data never leaves your git host, meaning anyone with read access to the repo can read the plan, just like the code.
