An MCP (Model Context Protocol) server that integrates BugHerd bug tracking with AI assistants. Complete BugHerd API v2 coverage with 38 tools across all resource types: - Organization - Get account details - Users - List members, guests, user tasks and projects - Projects - CRUD operations, manage members and guests - Tasks - Full task management including feedback, archived, and taskboard views
Add this skill
npx mdskills install Berckan/bugherd-mcpComprehensive BugHerd API integration with 37 well-organized tools and clear setup docs
An MCP (Model Context Protocol) server that integrates BugHerd bug tracking with AI assistants.
Complete BugHerd API v2 coverage with 38 tools across all resource types:
git clone https://github.com/berckan/bugherd-mcp.git
cd bugherd-mcp
bun install
# or
npm install
bun run build
# or
npm run build
export BUGHERD_API_KEY=your-api-key-here
Add to your MCP client config:
{
"mcpServers": {
"bugherd": {
"type": "stdio",
"command": "node",
"args": ["/path/to/bugherd-mcp/dist/index.js"],
"env": {
"BUGHERD_API_KEY": "your-api-key-here"
}
}
}
}
Add to your MCP desktop app config:
{
"mcpServers": {
"bugherd": {
"command": "node",
"args": ["/path/to/bugherd-mcp/dist/index.js"],
"env": {
"BUGHERD_API_KEY": "your-api-key-here"
}
}
}
}
| Tool | Description |
|---|---|
bugherd_get_organization | Get organization/account details |
| Tool | Description |
|---|---|
bugherd_list_users | List all users (members + guests) |
bugherd_list_members | List only team members |
bugherd_list_guests | List only guests/clients |
bugherd_get_user_tasks | Get tasks assigned to a user |
bugherd_get_user_projects | Get projects for a user |
| Tool | Description |
|---|---|
bugherd_list_projects | List all projects |
bugherd_list_active_projects | List only active projects |
bugherd_get_project | Get project details |
bugherd_create_project | Create a new project |
bugherd_update_project | Update project settings |
bugherd_delete_project | ⚠️ Delete a project permanently |
bugherd_add_member | Add a member to a project |
bugherd_add_guest | Add a guest to a project |
| Tool | Description |
|---|---|
bugherd_list_tasks | List tasks with filters (status, priority, tag) |
bugherd_list_feedback_tasks | List unprocessed feedback tasks |
bugherd_list_archived_tasks | List archived tasks |
bugherd_list_taskboard_tasks | List taskboard tasks |
bugherd_get_task | Get task details with metadata |
bugherd_get_task_global | Get task by global ID |
bugherd_get_task_by_local_id | Get task by local ID (#123) |
bugherd_create_task | Create a new task |
bugherd_move_tasks | Move tasks between projects |
bugherd_update_task | Update task status/priority/description/assignee |
| Tool | Description |
|---|---|
bugherd_list_columns | List project columns (Kanban statuses) |
bugherd_get_column | Get column details |
bugherd_create_column | Create a new column |
bugherd_update_column | Update column name/position |
| Tool | Description |
|---|---|
bugherd_list_comments | List comments on a task |
bugherd_create_comment | Add a comment to a task |
| Tool | Description |
|---|---|
bugherd_list_attachments | List task attachments |
bugherd_get_attachment | Get attachment details |
bugherd_create_attachment | Create attachment from URL |
bugherd_delete_attachment | ⚠️ Delete an attachment |
| Tool | Description |
|---|---|
bugherd_list_webhooks | List configured webhooks |
bugherd_create_webhook | Create a webhook |
bugherd_delete_webhook | ⚠️ Delete a webhook |
List my BugHerd projects
Show me all critical bugs in project 12345
Create a task in project 12345: "Fix the login button alignment"
Move task 678 from project 12345 to project 67890
Update task 678 status to "done"
Show comments on task 678 in project 12345
Add a comment to task 678: "Fixed in latest deploy"
List all webhooks
Create a webhook for task_create events pointing to https://example.com/webhook
bun run dev
BUGHERD_API_KEY=xxx bun run inspector
bun run build
BugHerd allows an average of 60 requests per minute with bursts of up to 10 in quick succession. The server handles rate limiting errors gracefully.
MIT
Berckan Guerrero (hi@berck.io)
Contributions are welcome! Please open an issue or submit a pull request.
Install via CLI
npx mdskills install Berckan/bugherd-mcpBugHerd MCP Server is a free, open-source AI agent skill. An MCP (Model Context Protocol) server that integrates BugHerd bug tracking with AI assistants. Complete BugHerd API v2 coverage with 38 tools across all resource types: - Organization - Get account details - Users - List members, guests, user tasks and projects - Projects - CRUD operations, manage members and guests - Tasks - Full task management including feedback, archived, and taskboard views
Install BugHerd MCP Server with a single command:
npx mdskills install Berckan/bugherd-mcpThis downloads the skill files into your project and your AI agent picks them up automatically.
BugHerd MCP Server works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.