Bugherd Mcp

io.github.BerckanPublished by GitHub account Berckanv0.2.0Updated Oct 24, 2026

BugHerd API v2 integration — 37 tools for projects, tasks, comments, and webhooks.

The publisher's own server: BugHerd

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Unofficial local MCP server for BugHerd bug tracking, letting an assistant read and manage projects, tasks, columns, comments, attachments and webhooks.

What you can do
Read organization and account details, and list users, members, guests, and their tasks and projects. List, create, update and delete projects, and add members or guests. List, create, move and update tasks, including feedback, archived and taskboard views. Manage Kanban columns and read or add task comments. List, create and delete attachments, and list, create and delete webhooks.
When to use it
Useful when a team tracks website feedback and bugs in BugHerd and wants an assistant to query projects and tasks, triage or update issues, add comments, or wire up webhooks without leaving the chat.
Requirements
Runs locally as a Node.js (18+) or Bun process, installed from the npm package or built from source. Needs a BugHerd account with API access and a BugHerd API key supplied in the BUGHERD_API_KEY environment variable. Network access to the BugHerd API; subject to its rate limits.
Before you install
The API key in BUGHERD_API_KEY grants access to the BugHerd account and should be kept out of shared configs. Several tools write or destroy data: creating and updating projects, tasks, columns, comments and webhooks, plus permanent deletion of projects, attachments and webhooks. Webhooks can send event data to external URLs you configure. This is a community project, not an official BugHerd server.

Installation

In SourceWeft

  1. Open Bugherd Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:
bash
git clone https://github.com/berckan/bugherd-mcp.gitcd bugherd-mcp
  1. Install dependencies:
bash
bun install# ornpm install
  1. Build the server:
bash
bun run build# ornpm run build
  1. Set your API key:
bash
export BUGHERD_API_KEY=your-api-key-here

Configuration

CLI Configuration

Add to your MCP client config:

json
{  "mcpServers": {    "bugherd": {      "type": "stdio",      "command": "node",      "args": ["/path/to/bugherd-mcp/dist/index.js"],      "env": {        "BUGHERD_API_KEY": "your-api-key-here"      }    }  }}

Desktop Apps

Add to your MCP desktop app config:

json
{  "mcpServers": {    "bugherd": {      "command": "node",      "args": ["/path/to/bugherd-mcp/dist/index.js"],      "env": {        "BUGHERD_API_KEY": "your-api-key-here"      }    }  }}

Available Tools (37)

Organization

ToolDescription
bugherd_get_organizationGet organization/account details

Users

ToolDescription
bugherd_list_usersList all users (members + guests)
bugherd_list_membersList only team members
bugherd_list_guestsList only guests/clients
bugherd_get_user_tasksGet tasks assigned to a user
bugherd_get_user_projectsGet projects for a user

Projects

ToolDescription
bugherd_list_projectsList all projects
bugherd_list_active_projectsList only active projects
bugherd_get_projectGet project details
bugherd_create_projectCreate a new project
bugherd_update_projectUpdate project settings
bugherd_delete_project⚠️ Delete a project permanently
bugherd_add_memberAdd a member to a project
bugherd_add_guestAdd a guest to a project

Tasks

ToolDescription
bugherd_list_tasksList tasks with filters (status, priority, tag)
bugherd_list_feedback_tasksList unprocessed feedback tasks
bugherd_list_archived_tasksList archived tasks
bugherd_list_taskboard_tasksList taskboard tasks
bugherd_get_taskGet task details with metadata
bugherd_get_task_globalGet task by global ID
bugherd_get_task_by_local_idGet task by local ID (#123)
bugherd_create_taskCreate a new task
bugherd_move_tasksMove tasks between projects
bugherd_update_taskUpdate task status/priority/description/assignee

Columns

ToolDescription
bugherd_list_columnsList project columns (Kanban statuses)
bugherd_get_columnGet column details
bugherd_create_columnCreate a new column
bugherd_update_columnUpdate column name/position

Comments

ToolDescription
bugherd_list_commentsList comments on a task
bugherd_create_commentAdd a comment to a task

Attachments

ToolDescription
bugherd_list_attachmentsList task attachments
bugherd_get_attachmentGet attachment details
bugherd_create_attachmentCreate attachment from URL
bugherd_delete_attachment⚠️ Delete an attachment

Webhooks

ToolDescription
bugherd_list_webhooksList configured webhooks
bugherd_create_webhookCreate a webhook
bugherd_delete_webhook⚠️ Delete a webhook

Usage Examples

List projects and tasks

List my BugHerd projectsShow me all critical bugs in project 12345

Create and manage tasks

Create a task in project 12345: "Fix the login button alignment"Move task 678 from project 12345 to project 67890Update task 678 status to "done"

Work with comments

Show comments on task 678 in project 12345Add a comment to task 678: "Fixed in latest deploy"

Manage webhooks

List all webhooksCreate a webhook for task_create events pointing to https://example.com/webhook

Development

Run in development mode:

bash
bun run dev

Test with MCP Inspector:

bash
BUGHERD_API_KEY=xxx bun run inspector

Build for production:

bash
bun run build

API Rate Limits

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.

License

MIT

Author

Berckan Guerrero

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Related

Source: README.md at commit f9f0720

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Bugherd integrations

BugHerd

com.bugherdOfficial publisher

Official BugHerd remote MCP server that lets an assistant work with BugHerd website feedback and bug tracking after an OAuth sign-in.

Streamable HTTPWeb executableAuth
Productivity & WorkflowCredential requiredOct 29, 2026