1. Conduid
  2. Developer Tools
  3. Berckan/bugherd-mcp
MCP server · Developer Tools

Berckan/bugherd-mcp

by · github.com/Berckan/bugherd-mcp

MCP server for BugHerd integration - manage bugs and feedback from Claude

Unclaimed MIT bugherdmcpmcp-server
InstallView source
56Fair

Scored 14 days ago · breakdown

About Berckan/bugherd-mcp

Berckan/bugherd-mcp is an MCP server published by Berckan in the Developer Tools category: mCP server for BugHerd integration - manage bugs and feedback from Claude.

The repository has 7 stars and 5 forks, with the last commit 5 months ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/Berckan/bugherd-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (1)

bugherd_get_organizationGet organization/account details

Parameters not published.

Ask AI

✦

Ask AI about Berckan/bugherd-mcp

Powered by Claude · Grounded in docs

I know everything about Berckan/bugherd-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v0.2.3v0.2.3

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

Configuration

CLI Configuration

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

Desktop Apps

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

Available Tools (37)

Organization

Tool Description
bugherd_get_organization Get organization/account details

Users

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

Projects

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

Tasks

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

Columns

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

Comments

Tool Description
bugherd_list_comments List comments on a task
bugherd_create_comment Add a comment to a task

Attachments

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

Webhooks

Tool Description
bugherd_list_webhooks List configured webhooks
bugherd_create_webhook Create a webhook
bugherd_delete_webhook ⚠️ Delete a webhook

Usage Examples

List projects and tasks

List my BugHerd projects
Show 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 67890
Update task 678 status to "done"

Work with comments

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

Manage webhooks

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

Development

Run in development mode:

bun run dev

Test with MCP Inspector:

BUGHERD_API_KEY=xxx bun run inspector

Build for production:

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

README fetched from the repository 7 days ago. The original is authoritative.

Questions

About Berckan/bugherd-mcp

How do I install Berckan/bugherd-mcp?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Berckan/bugherd-mcp safe to use with an AI agent?

Its trust score is 56 out of 100 (fair). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Berckan/bugherd-mcp still maintained?

Yes — the last commit was 5 months ago. The repository has 7 stars and 5 forks.