berckan avatar

Bugherd Mcp

berckan/bugherd-mcp

Connects to the BugHerd API v2 and exposes 37 tools covering the full scope of bug tracking operations. You get full CRUD on projects and tasks, comment threads, file attachments, custom Kanban columns, and webhook management. Useful when you're triaging bugs, moving tasks between projects, or updating statuses without leaving your AI workflow. It handles organization details, member and guest management, and filtered task views including feedback queues and archived items. This is the community maintained open source version that runs locally. BugHerd themselves ship a closed source hosted alternative if you prefer that route.

GitHub stars
5
tools
37
auth
Secret needed
transport
STDIO
env var
1
last updated
Feb 11, 2026

Tools

37 tools

Public tool metadata for what this MCP can expose to an agent.

bugherd_get_organizationGet organization/account details

Get organization/account details

No parameter schema in public metadata yet.

bugherd_list_usersList all users (members + guests)

List all users (members + guests)

No parameter schema in public metadata yet.

bugherd_list_membersList only team members

List only team members

No parameter schema in public metadata yet.

bugherd_list_guestsList only guests/clients

List only guests/clients

No parameter schema in public metadata yet.

bugherd_get_user_tasksGet tasks assigned to a user

Get tasks assigned to a user

No parameter schema in public metadata yet.

bugherd_get_user_projectsGet projects for a user

Get projects for a user

No parameter schema in public metadata yet.

bugherd_list_projectsList all projects

List all projects

No parameter schema in public metadata yet.

bugherd_list_active_projectsList only active projects

List only active projects

No parameter schema in public metadata yet.

bugherd_get_projectGet project details

Get project details

No parameter schema in public metadata yet.

bugherd_create_projectCreate a new project

Create a new project

No parameter schema in public metadata yet.

bugherd_update_projectUpdate project settings

Update project settings

No parameter schema in public metadata yet.

bugherd_delete_project⚠️ Delete a project permanently

⚠️ Delete a project permanently

No parameter schema in public metadata yet.

bugherd_add_memberAdd a member to a project

Add a member to a project

No parameter schema in public metadata yet.

bugherd_add_guestAdd a guest to a project

Add a guest to a project

No parameter schema in public metadata yet.

bugherd_list_tasksList tasks with filters (status, priority, tag)

List tasks with filters (status, priority, tag)

No parameter schema in public metadata yet.

bugherd_list_feedback_tasksList unprocessed feedback tasks

List unprocessed feedback tasks

No parameter schema in public metadata yet.

bugherd_list_archived_tasksList archived tasks

List archived tasks

No parameter schema in public metadata yet.

bugherd_list_taskboard_tasksList taskboard tasks

List taskboard tasks

No parameter schema in public metadata yet.

bugherd_get_taskGet task details with metadata

Get task details with metadata

No parameter schema in public metadata yet.

bugherd_get_task_globalGet task by global ID

Get task by global ID

No parameter schema in public metadata yet.

bugherd_get_task_by_local_idGet task by local ID (#123)

Get task by local ID (#123)

No parameter schema in public metadata yet.

bugherd_create_taskCreate a new task

Create a new task

No parameter schema in public metadata yet.

bugherd_move_tasksMove tasks between projects

Move tasks between projects

No parameter schema in public metadata yet.

bugherd_update_taskUpdate task status/priority/description/assignee

Update task status/priority/description/assignee

No parameter schema in public metadata yet.

bugherd_list_columnsList project columns (Kanban statuses)

List project columns (Kanban statuses)

No parameter schema in public metadata yet.

bugherd_get_columnGet column details

Get column details

No parameter schema in public metadata yet.

bugherd_create_columnCreate a new column

Create a new column

No parameter schema in public metadata yet.

bugherd_update_columnUpdate column name/position

Update column name/position

No parameter schema in public metadata yet.

bugherd_list_commentsList comments on a task

List comments on a task

No parameter schema in public metadata yet.

bugherd_create_commentAdd a comment to a task

Add a comment to a task

No parameter schema in public metadata yet.

bugherd_list_attachmentsList task attachments

List task attachments

No parameter schema in public metadata yet.

bugherd_get_attachmentGet attachment details

Get attachment details

No parameter schema in public metadata yet.

bugherd_create_attachmentCreate attachment from URL

Create attachment from URL

No parameter schema in public metadata yet.

bugherd_delete_attachment⚠️ Delete an attachment

⚠️ Delete an attachment

No parameter schema in public metadata yet.

bugherd_list_webhooksList configured webhooks

List configured webhooks

No parameter schema in public metadata yet.

bugherd_create_webhookCreate a webhook

Create a webhook

No parameter schema in public metadata yet.

bugherd_delete_webhook⚠️ Delete a webhook

⚠️ Delete a webhook

No parameter schema in public metadata yet.

Sponsors

Configuration

BUGHERD_API_KEY*secret

BugHerd API key from Settings > General Settings

Readme

BugHerd MCP Server

Note: This is an unofficial, community-maintained, open-source (MIT) BugHerd MCP server. It runs locally, your data never leaves your machine. For BugHerd's official closed-source hosted server, see macropodhq/bugherd-mcp.

An MCP (Model Context Protocol) server that integrates BugHerd bug tracking with AI assistants.

Features

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
  • Columns - Custom Kanban board management
  • Comments - Read and create comments
  • Attachments - Manage file attachments
  • Webhooks - Configure event notifications

Installation

Prerequisites

  • Node.js 18+ or Bun
  • A BugHerd account with API access
  • BugHerd API key (get it from Settings > General Settings)

Setup

  1. Clone the repository:

View the full README on GitHub

Details

Repository
github.com/berckan/bugherd-mcp
Package
bugherd-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active