# bugherd-mcp

Connects BugHerd to your AI agent so it can read and update projects, tasks, comments and webhooks over API v2. Useful when bug reports live in BugHerd but you work in the editor.

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

## What it does

The server wraps BugHerd API v2 in 37 tools, all named with a `bugherd_` prefix. They reach organizations, users, projects, tasks, Kanban columns, comments, attachments and webhooks. Tasks can be filtered by status, priority or tag, and fetched by global ID or by a local number like #123.

Write access is there too. An agent can open a task, move it to another project, change its status, assignee or description, and post a comment. Columns and project members are editable as well.

It runs locally as an unofficial, MIT-licensed build. You need an API key from Settings > General Settings in BugHerd, passed as `BUGHERD_API_KEY`. `bugherd_delete_project` removes a project for good, so keep manual approval on for that call. BugHerd averages 60 requests per minute with bursts of 10, and the server handles rate-limit errors itself.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BUGHERD_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 bugherd-mcp -e BUGHERD_API_KEY=<BUGHERD_API_KEY> -- npx -y bugherd-mcp
```
Replace <…> with your own values

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- list every critical bug in a BugHerd project from the chat
- file a new task straight from a bug description
- move a batch of tasks between projects
- post a comment on a task once the fix is deployed
- register a webhook for `task_create` events

## Example prompts
- List the critical bugs in BugHerd project 12345
- Create a BugHerd task in project 12345 about the misaligned login button
- Comment on BugHerd task 678 in project 12345 that the fix has shipped

## Similar
- [api-test-mode-design](https://affpapa.org/en/nevibecode/skills/api-test-mode-design.md) — skill · 7800 installs
- [webhook-integration](https://affpapa.org/en/nevibecode/skills/webhook-integration.md) — skill · 1100 installs
- [qa-expert](https://affpapa.org/en/nevibecode/skills/qa-expert.md) — skill · 2000 installs
- [bug-report](https://affpapa.org/en/nevibecode/skills/bug-report.md) — skill · 473 installs
- [bug-triage](https://affpapa.org/en/nevibecode/skills/bug-triage.md) — skill · 422 installs
- [FlurryPORT](https://affpapa.org/en/nevibecode/mcp/flurryport.md) — MCP server

---
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