Too Many Cooks

Coordinate multiple AI agents working on the same codebase. File locking, messaging, and shared plans — no more conflicts.

Get Started GitHub

Install and start

npm install -g too-many-cooks && too-many-cooks

Claude Code

claude mcp add --transport http --scope user too-many-cooks http://localhost:4040/mcp

Codex

codex --mcp-server http://localhost:4040/mcp

Cursor / Cline — add to mcp.json

{
  "mcpServers": {
    "too-many-cooks": {
      "url": "http://localhost:4040/mcp"
    }
  }
}

Too Many Cooks is an MCP server that lets multiple AI agents coordinate when editing the same codebase. Agents register with a key, lock files before editing, post messages to each other, and share plans. It prevents conflicts and keeps agents in sync.

Coordination Tools

Five MCP tools for multi-agent coordination.

R

Register

Each agent registers with a unique key on startup. Required before using any other tool.

Learn more →
L

Lock

Lock files or resources before editing. Other agents see the lock and wait or choose a different file.

Learn more →
M

Messages

Post and read messages between agents. Keep other agents informed about your progress and intent.

Learn more →
P

Plans

Share your plan with other agents before starting. Avoid redundant work and coordinate changes.

Learn more →
S

Status

Check the current state — who is registered, what is locked, what plans are active.

Learn more →