Skip to main content
Glama
BugHerd MCP Server

BugHerd MCP Server

by Berckan

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

Related MCP server: onion-mcp-server

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.

Available Tools

37 tools
bugherd_add_guestB

Add a guest/client to a project by user ID or email.

Inputs: project_id (required), user_id, email.

bugherd_add_memberC

Add a team member to a project.

Inputs: project_id (required), user_id (required).

bugherd_create_attachmentB

Create an attachment from a URL.

Inputs: project_id (required), task_id (required), file_name (required), url (required).

bugherd_create_columnB

Create a new column in a project's Kanban board.

Inputs: project_id (required), name (required), position.

bugherd_create_commentC

Add a comment to a task.

Inputs: project_id (required), task_id (required), text (required), user_id, +1 more.

bugherd_create_projectC

Create a new BugHerd project.

Inputs: name (required), devurl (required), is_active, is_public.

bugherd_create_taskB

Create a new task/bug in a project.

Inputs: project_id (required), description (required), priority, status, +4 more.

bugherd_create_webhookB

Create a webhook to receive notifications for BugHerd events.

Inputs: event (required), target_url (required), project_id.

bugherd_delete_attachmentB

⚠️ DESTRUCTIVE: Delete an attachment permanently.

Inputs: project_id (required), task_id (required), attachment_id (required).

bugherd_delete_projectA

⚠️ DESTRUCTIVE: Delete a project and all its tasks permanently.

Inputs: project_id (required).

bugherd_delete_webhookB

⚠️ DESTRUCTIVE: Delete a webhook permanently.

Inputs: webhook_id (required).

bugherd_get_attachmentC

Get details of a specific attachment.

Inputs: project_id (required), task_id (required), attachment_id (required).

bugherd_get_columnC

Get details of a specific column.

Inputs: project_id (required), column_id (required).

bugherd_get_organizationA

Get organization/account details including name and timezone.

Inputs: no named parameters.

bugherd_get_projectC

Get details of a specific project.

Inputs: project_id (required).

bugherd_get_taskB

Get detailed information about a specific task including description, screenshot URL, selector info, and metadata.

Inputs: project_id (required), task_id (required).

bugherd_get_task_by_local_idB

Get a task by its local ID (#123) within a project.

Inputs: project_id (required), local_task_id (required).

bugherd_get_task_globalA

Get a task by its global ID (without needing the project ID).

Inputs: task_id (required).

bugherd_get_user_projectsC

Get projects accessible to a specific user.

Inputs: user_id (required).

bugherd_get_user_tasksA

Get tasks assigned to a specific user.

Inputs: user_id (required), status, priority, page.

bugherd_list_active_projectsA

List only active projects.

Inputs: no named parameters.

bugherd_list_archived_tasksC

List archived tasks for a project.

Inputs: project_id (required), page.

bugherd_list_attachmentsB

List all attachments on a task.

Inputs: project_id (required), task_id (required).

bugherd_list_columnsA

List all columns (statuses) for a project. Use this to find the correct status names for updating tasks in projects with custom Kanban boards.

Inputs: project_id (required).

bugherd_list_commentsB

List all comments on a specific task. Returns comment text, author, and timestamp.

Inputs: project_id (required), task_id (required).

bugherd_list_feedback_tasksA

List feedback tasks (unprocessed/new) for a project.

Inputs: project_id (required), page.

bugherd_list_guestsA

List only guests/clients in the organization.

Inputs: no named parameters.

bugherd_list_membersA

List only team members in the organization.

Inputs: no named parameters.

bugherd_list_projectsA

List all BugHerd projects accessible to the authenticated user. Returns project names, URLs, and IDs.

Inputs: no named parameters.

bugherd_list_taskboard_tasksA

List taskboard tasks (not feedback, not archived) for a project.

Inputs: project_id (required), page.

bugherd_list_tasksA

List tasks (bugs/feedback) for a specific BugHerd project. Can filter by status (use column name from bugherd_list_columns), priority, or tag.

Inputs: project_id (required), status, priority, tag, +1 more.

bugherd_list_usersA

List all users (members + guests) in the organization.

Inputs: no named parameters.

bugherd_list_webhooksA

List all webhooks configured for the organization.

Inputs: no named parameters.

bugherd_move_tasksB

Move tasks from one project to another.

Inputs: project_id (required), task_ids (required), destination_project_id (required).

bugherd_update_columnB

Update a column's name or position.

Inputs: project_id (required), column_id (required), name, position.

bugherd_update_projectC

Update a project's settings.

Inputs: project_id (required), name, devurl, is_active, +1 more.

bugherd_update_taskA

Update a task's status, priority, description, or assignee. Use this to mark tasks as done, move them through workflow stages, or assign them to users.

Inputs: project_id (required), task_id (required), status, priority, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 37 tools

    Disambiguation5/5

    Every tool targets a distinct resource or subset, with clear naming and descriptions that prevent confusion. Even similar tools like list_tasks, list_feedback_tasks, and list_taskboard_tasks are precisely differentiated.

    Naming Consistency5/5

    All tools follow the consistent pattern 'bugherd_verb_noun' with optional qualifiers (e.g., get_task_by_local_id). The snake_case naming is uniform and predictable.

    Tool Count4/5

    With 37 tools, the count is above the typical 3-15 range, but it is justified by the breadth of features (projects, tasks, columns, attachments, comments, users, webhooks, etc.). It's slightly over but still reasonable.

    Completeness3/5

    The tool set covers most CRUD operations for major resources, but notable gaps exist: no delete for tasks, columns, or comments, and no update/delete for comments. This limits lifecycle coverage.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server providing over 390 tools across 66 providers, including major SaaS platforms like GitHub, Slack, and Stripe. It enables AI assistants to interact directly with a wide array of public APIs and utility services through a single interface.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that gives AI coding assistants QA superpowers, enabling users to report bugs by pointing, clicking, or typing while automatically capturing diagnostic data for AI-driven test-feedback-fix loops.
      4
      MIT