BugHerd MCP Server
The BugHerd MCP Server integrates BugHerd bug tracking with AI assistants, providing full API v2 coverage through 38 tools for managing your BugHerd data locally via the MCP protocol.
Organization
Retrieve organization/account details (name, timezone, etc.)
Users
List all users, members only, or guests only
Get tasks assigned to a specific user (with filters for status, priority, pagination)
Get projects accessible to a specific user
Projects
List all or only active projects; get project details
Create, update, or permanently delete projects
Add team members or guests to a project
Tasks
List tasks with filters (status, priority, tag, pagination)
List feedback (unprocessed), archived, or taskboard tasks
Get task details by project+task ID, global ID, or local ID
Create tasks with priority, tags, assignee, and status
Update task status, priority, description, or assignee
Move tasks between projects
Columns (Kanban Board)
List, get, create, and update columns/statuses for a project
Comments
List comments on a task and add new comments
Attachments
List, get details, create (from URL), or permanently delete task attachments
Webhooks
List, create, and delete webhooks for events like
task_create,task_update,comment,project_create, andtask_destroy
All operations run locally via the MCP protocol, so data never leaves your machine.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BugHerd MCP Server list my open tasks for the main project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Clone the repository:
git clone https://github.com/berckan/bugherd-mcp.git
cd bugherd-mcpInstall dependencies:
bun install
# or
npm installBuild the server:
bun run build
# or
npm run buildSet your API key:
export BUGHERD_API_KEY=your-api-key-hereConfiguration
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 |
| Get organization/account details |
Users
Tool | Description |
| List all users (members + guests) |
| List only team members |
| List only guests/clients |
| Get tasks assigned to a user |
| Get projects for a user |
Projects
Tool | Description |
| List all projects |
| List only active projects |
| Get project details |
| Create a new project |
| Update project settings |
| ⚠️ Delete a project permanently |
| Add a member to a project |
| Add a guest to a project |
Tasks
Tool | Description |
| List tasks with filters (status, priority, tag) |
| List unprocessed feedback tasks |
| List archived tasks |
| List taskboard tasks |
| Get task details with metadata |
| Get task by global ID |
| Get task by local ID (#123) |
| Create a new task |
| Move tasks between projects |
| Update task status/priority/description/assignee |
Columns
Tool | Description |
| List project columns (Kanban statuses) |
| Get column details |
| Create a new column |
| Update column name/position |
Comments
Tool | Description |
| List comments on a task |
| Add a comment to a task |
Attachments
Tool | Description |
| List task attachments |
| Get attachment details |
| Create attachment from URL |
| ⚠️ Delete an attachment |
Webhooks
Tool | Description |
| List configured webhooks |
| Create a webhook |
| ⚠️ Delete a webhook |
Usage Examples
List projects and tasks
List my BugHerd projects
Show me all critical bugs in project 12345Create 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/webhookDevelopment
Run in development mode:
bun run devTest with MCP Inspector:
BUGHERD_API_KEY=xxx bun run inspectorBuild for production:
bun run buildAPI 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
Contributing
Contributions are welcome! Please open an issue or submit a pull request.
Related
Available Tools
37 toolsbugherd_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
Scored across 37 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
An MCP server that integrates with Discord to provide AI-powered features.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
AI tool directory MCP server, live since July 2026. Tools, agents, models, companies, services.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA 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.-

onion-mcp-serverofficial
AlicenseAqualityDmaintenanceA feature-rich MCP server offering 30 tools across AI, code, text, data, web, and system categories, enabling tasks like chat, translation, code review, web scraping, and text processing.30MIT- AlicenseNot gradedqualityDmaintenanceAn 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.4MIT
- AlicenseAqualityCmaintenanceMCP server for PixelFixer, a visual bug tracking and kanban board tool. Connects AI agents to your PixelFixer projects.2610 npmMIT