Back to Browse
Free
Server data from the Official MCP Registry
BugHerd API v2 integration — 37 tools for projects, tasks, comments, and webhooks.
About
BugHerd API v2 integration — 37 tools for projects, tasks, comments, and webhooks.
Security Report
10.0
Low Risk10.0Low RiskValid MCP server (2 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
3 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
What You'll Need
Set these up before or after installing:
BugHerd API key from Settings > General SettingsRequired
Environment variable: BUGHERD_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-berckan-bugherd-mcp": {
"env": {
"BUGHERD_API_KEY": "your-bugherd-api-key-here"
},
"args": [
"-y",
"bugherd-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
BugHerd MCP Server
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-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 (hi@berck.io)
Contributing
Contributions are welcome! Please open an issue or submit a pull request.
Related
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
4
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
409
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
56
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
116.1K
Stars
15
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
14
Installs
10.0
Security
5.0
Local
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
-
Stars
13
Installs
10.0
Security
No ratings yet
Local