BeadsMCP

This project is a stdio MCP server that exposes Beads CLI commands as MCP tools. It lets MCP clients (for example VS Code Copilot Chat in agent mode) call Beads through structured tool invocations.

It maps MCP tool calls to Beads CLI operations:

• beads_init
• beads_ready
• beads_list
• beads_show
• beads_create
• beads_close
• beads_dep_add
• beads_exec (advanced/raw command passthrough)

You need all of the following:

1. Node.js installed (recommended Node 18+)
2. @beads/bd installed globally or locally (you need bd.exe on Windows)
3. Dolt installed and available in PATH (Beads uses Dolt for state/repository backend)

Global install:

npm install -g @beads/bd

Local install (inside this wrapper folder):

cd scripts/beads-mcp-server
npm install @beads/bd

Install Dolt from:

https://docs.dolthub.com/introduction/installation

After install, verify:

dolt --version

cd scripts/beads-mcp-server
npm install

Add this server under servers in your VS Code user MCP config.

"beads-wrapper": {
  "type": "stdio",
  "command": "node",
  "args": [
    "C:/path/server.mjs"
  ],
  "env": {
    "BEADS_CWD": "workingdir",
    "BEADS_BIN": "Pathtobid"
  }
}

You can omit BEADS_BIN, and the wrapper will use:

• Windows: bd.exe
• Linux/macOS: bd

The wrapper supports these environment variables:

• `BEA