Berckan/bugherd-mcp

> **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:
2. Install dependencies:
3. Build the server:
4. Set your API key:
Configuration
CLI Configuration
Add to your MCP client config:
Desktop Apps
Add to your MCP desktop app config:
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