# killbottleneck

Links self-hosted goal and process maps to your coding assistant via MCP. Useful for tracking project blockers and milestones without routing team data to external clouds.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: tengolabs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tengolabs/killbottleneck
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/killbottleneck

## What it does

killBottleneck runs on your own infrastructure via Docker, turning projects into visual graphs of goals and dependencies. The assistant connects to this instance through the `killbottleneck-mcp` package. This setup lets an AI agent inspect work structures directly.

The platform provides a daily task overview alongside built-in time tracking. It operates with zero telemetry by default: fonts load locally, and external calls to language models happen only when explicitly configured in the environment file.

Without a running killBottleneck container and both `KB_URL` and `KB_API_KEY` values present, the MCP server will not start.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KB_URL`, `KB_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add killbottleneck -e KB_URL=<KB_URL> -e KB_API_KEY=<KB_API_KEY> -- npx -y killbottleneck-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add killbottleneck --env KB_URL=<KB_URL> --env KB_API_KEY=<KB_API_KEY> -- npx -y killbottleneck-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "killbottleneck": {
            "command": "npx",
            "args": [
                "-y",
                "killbottleneck-mcp"
            ],
            "env": {
                "KB_URL": "<KB_URL>",
                "KB_API_KEY": "<KB_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "killbottleneck": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "killbottleneck-mcp"
            ],
            "env": {
                "KB_URL": "<KB_URL>",
                "KB_API_KEY": "<KB_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KB_URL=<KB_URL> -e KB_API_KEY=<KB_API_KEY> killbottleneck npx -y killbottleneck-mcp
```
Replace <…> with your own values

## When to use it
- inspect project goal maps and task dependencies from the coding assistant
- find overdue or blocking steps directly within the daily plan
- break down project milestones into sub-tasks inside a private instance
- keep company project planning data on your own hardware without external leaks

## Example prompts
- Show all tasks in the current goal map that are blocking other team members.
- List my overdue goals for today from the self-hosted workspace.
- Create intermediate milestones for the database migration node in killBottleneck.

## Similar
- [Asana Automation](https://affpapa.org/en/nevibecode/skills/asana-automation.md) — skill · 6900 installs
- [asana](https://affpapa.org/en/nevibecode/skills/asana.md) — skill · 1900 installs
- [planka](https://affpapa.org/en/nevibecode/mcp/planka.md) — MCP server · ★ 12
- [ClickUp Automation](https://affpapa.org/en/nevibecode/skills/clickup-automation.md) — skill · 4800 installs
- [monday-com](https://affpapa.org/en/nevibecode/plugins/monday-com.md) — plugin · ★ 7604
- [cabinet-ai-knowledge-base](https://affpapa.org/en/nevibecode/skills/cabinet-ai-knowledge-base.md) — skill · 607 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md