Bugherd MCP server
io.github.Berckan/bugherd-mcp·v0.2.0·7 starsBugHerd API v2 integration — 37 tools for projects, tasks, comments, and webhooks.
7 stars
Reviews
Write oneNobody has reviewed Bugherd yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Bugherd tools (37, 12 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
bugherd_add_guestAdd a guest/client to a project by user ID or email.
bugherd_add_memberAdd a team member to a project.
bugherd_create_attachmentwrite actionCreate an attachment from a URL.
bugherd_create_columnwrite actionCreate a new column in a project's Kanban board.
bugherd_create_commentwrite actionAdd a comment to a task.
bugherd_create_projectwrite actionCreate a new BugHerd project.
bugherd_create_taskwrite actionCreate a new task/bug in a project.
bugherd_create_webhookwrite actionCreate a webhook to receive notifications for BugHerd events.
bugherd_delete_attachmentwrite action⚠️ DESTRUCTIVE: Delete an attachment permanently.
bugherd_delete_projectwrite action⚠️ DESTRUCTIVE: Delete a project and all its tasks permanently.
bugherd_delete_webhookwrite action⚠️ DESTRUCTIVE: Delete a webhook permanently.
bugherd_get_attachmentGet details of a specific attachment.
bugherd_get_columnGet details of a specific column.
bugherd_get_organizationGet organization/account details including name and timezone.
bugherd_get_projectGet details of a specific project.
bugherd_get_taskGet detailed information about a specific task including description, screenshot URL, selector info, and metadata.
bugherd_get_task_by_local_idGet a task by its local ID (#123) within a project.
bugherd_get_task_globalGet a task by its global ID (without needing the project ID).
bugherd_get_user_projectsGet projects accessible to a specific user.
bugherd_get_user_tasksGet tasks assigned to a specific user.
bugherd_list_active_projectsList only active projects.
bugherd_list_archived_tasksList archived tasks for a project.
bugherd_list_attachmentsList all attachments on a task.
bugherd_list_columnsList all columns (statuses) for a project. Use this to find the correct status names for updating tasks in projects with custom Kanban boards.
bugherd_list_commentsList all comments on a specific task. Returns comment text, author, and timestamp.
bugherd_list_feedback_tasksList feedback tasks (unprocessed/new) for a project.
bugherd_list_guestsList only guests/clients in the organization.
bugherd_list_membersList only team members in the organization.
bugherd_list_projectsList all BugHerd projects accessible to the authenticated user. Returns project names, URLs, and IDs.
bugherd_list_taskboard_tasksList taskboard tasks (not feedback, not archived) for a project.
bugherd_list_tasksList tasks (bugs/feedback) for a specific BugHerd project. Can filter by status (use column name from bugherd_list_columns), priority, or tag.
bugherd_list_usersList all users (members + guests) in the organization.
bugherd_list_webhooksList all webhooks configured for the organization.
bugherd_move_tasksMove tasks from one project to another.
bugherd_update_columnwrite actionUpdate a column's name or position.
bugherd_update_projectwrite actionUpdate a project's settings.
bugherd_update_taskwrite actionUpdate a task's status, priority, or description. Use this to mark tasks as done or move them through workflow stages.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan10 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 123 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Bugherd compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 38% of 48,255 servers
- Tools
- 37
- the typical server has 7
- Tools that change things
- 32%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 7
- more than 86% of 28,688 servers
What its tools let an agent do: 25 read · 12 change
Install Bugherd in Claude Code, Cursor or VS Code
Runs npx -y bugherd-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add bugherd-mcp -- npx -y bugherd-mcp
What the publisher says
From the Bugherd repository's README, as published. We do not edit it. Read it on GitHub
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
- Clone the repository:
git clone https://github.com/berckan/bugherd-mcp.git
cd bugherd-mcp- Install dependencies:
bun install
# or
npm install- Build the server:
bun run build
# or
npm run build- Set 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
Users
Projects
Tasks
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Bugherd: common questions
- Is Bugherd MCP server safe?
- Mostly: it is graded B (72/100). Read the Bugherd safety report
- How do I install Bugherd?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Bugherd need an API key?
- Yes. The registry entry asks for
BUGHERD_API_KEY. - Is Bugherd maintained?
- The last commit was 160 days ago (2026-05-28). The latest release is v0.2.0.
- How does Bugherd compare with other MCP servers?
- safety score 72/100 (higher than 38% of 48,255 servers); tools 37 (the typical server has 7); tools that change things 32% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.