{
  "markdown": "# BugHerd MCP Server\n\n> **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](https://github.com/macropodhq/bugherd-mcp).\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that integrates [BugHerd](https://bugherd.com) bug tracking with AI assistants.\n\n## Features\n\n**Complete BugHerd API v2 coverage** with 38 tools across all resource types:\n\n- **Organization** - Get account details\n- **Users** - List members, guests, user tasks and projects\n- **Projects** - CRUD operations, manage members and guests\n- **Tasks** - Full task management including feedback, archived, and taskboard views\n- **Columns** - Custom Kanban board management\n- **Comments** - Read and create comments\n- **Attachments** - Manage file attachments\n- **Webhooks** - Configure event notifications\n\n## Installation\n\n### Prerequisites\n\n- Node.js 18+ or Bun\n- A BugHerd account with API access\n- BugHerd API key (get it from Settings > General Settings)\n\n### Setup\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/berckan/bugherd-mcp.git\ncd bugherd-mcp\n```\n\n2. Install dependencies:\n\n```bash\nbun install\n# or\nnpm install\n```\n\n3. Build the server:\n\n```bash\nbun run build\n# or\nnpm run build\n```\n\n4. Set your API key:\n\n```bash\nexport BUGHERD_API_KEY=your-api-key-here\n```\n\n## Configuration\n\n### CLI Configuration\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"bugherd\": {\n      \"type\": \"stdio\",\n      \"command\": \"node\",\n      \"args\": [\"/path/to/bugherd-mcp/dist/index.js\"],\n      \"env\": {\n        \"BUGHERD_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Desktop Apps\n\nAdd to your MCP desktop app config:\n\n```json\n{\n  \"mcpServers\": {\n    \"bugherd\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/bugherd-mcp/dist/index.js\"],\n      \"env\": {\n        \"BUGHERD_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools (37)\n\n### Organization\n\n| Tool                       | Description                      |\n| -------------------------- | -------------------------------- |\n| `bugherd_get_organization` | Get organization/account details |\n\n### Users\n\n| Tool                        | Description                       |\n| --------------------------- | --------------------------------- |\n| `bugherd_list_users`        | List all users (members + guests) |\n| `bugherd_list_members`      | List only team members            |\n| `bugherd_list_guests`       | List only guests/clients          |\n| `bugherd_get_user_tasks`    | Get tasks assigned to a user      |\n| `bugherd_get_user_projects` | Get projects for a user           |\n\n### Projects\n\n| Tool                           | Description                     |\n| ------------------------------ | ------------------------------- |\n| `bugherd_list_projects`        | List all projects               |\n| `bugherd_list_active_projects` | List only active projects       |\n| `bugherd_get_project`          | Get project details             |\n| `bugherd_create_project`       | Create a new project            |\n| `bugherd_update_project`       | Update project settings         |\n| `bugherd_delete_project`       | ⚠️ Delete a project permanently |\n| `bugherd_add_member`           | Add a member to a project       |\n| `bugherd_add_guest`            | Add a guest to a project        |\n\n### Tasks\n\n| Tool                           | Description                                      |\n| ------------------------------ | ------------------------------------------------ |\n| `bugherd_list_tasks`           | List tasks with filters (status, priority, tag)  |\n| `bugherd_list_feedback_tasks`  | List unprocessed feedback tasks                  |\n| `bugherd_list_archived_tasks`  | List archived tasks                              |\n| `bugherd_list_taskboard_tasks` | List taskboard tasks                             |\n| `bugherd_get_task`             | Get task details with metadata                   |\n| `bugherd_get_task_global`      | Get task by global ID                            |\n| `bugherd_get_task_by_local_id` | Get task by local ID (#123)                      |\n| `bugherd_create_task`          | Create a new task                                |\n| `bugherd_move_tasks`           | Move tasks between projects                      |\n| `bugherd_update_task`          | Update task status/priority/description/assignee |\n\n### Columns\n\n| Tool                    | Description                            |\n| ----------------------- | -------------------------------------- |\n| `bugherd_list_columns`  | List project columns (Kanban statuses) |\n| `bugherd_get_column`    | Get column details                     |\n| `bugherd_create_column` | Create a new column                    |\n| `bugherd_update_column` | Update column name/position            |\n\n### Comments\n\n| Tool                     | Description             |\n| ------------------------ | ----------------------- |\n| `bugherd_list_comments`  | List comments on a task |\n| `bugherd_create_comment` | Add a comment to a task |\n\n### Attachments\n\n| Tool                        | Description                |\n| --------------------------- | -------------------------- |\n| `bugherd_list_attachments`  | List task attachments      |\n| `bugherd_get_attachment`    | Get attachment details     |\n| `bugherd_create_attachment` | Create attachment from URL |\n| `bugherd_delete_attachment` | ⚠️ Delete an attachment    |\n\n### Webhooks\n\n| Tool                     | Description              |\n| ------------------------ | ------------------------ |\n| `bugherd_list_webhooks`  | List configured webhooks |\n| `bugherd_create_webhook` | Create a webhook         |\n| `bugherd_delete_webhook` | ⚠️ Delete a webhook      |\n\n## Usage Examples\n\n### List projects and tasks\n\n```\nList my BugHerd projects\nShow me all critical bugs in project 12345\n```\n\n### Create and manage tasks\n\n```\nCreate a task in project 12345: \"Fix the login button alignment\"\nMove task 678 from project 12345 to project 67890\nUpdate task 678 status to \"done\"\n```\n\n### Work with comments\n\n```\nShow comments on task 678 in project 12345\nAdd a comment to task 678: \"Fixed in latest deploy\"\n```\n\n### Manage webhooks\n\n```\nList all webhooks\nCreate a webhook for task_create events pointing to https://example.com/webhook\n```\n\n## Development\n\n### Run in development mode:\n\n```bash\nbun run dev\n```\n\n### Test with MCP Inspector:\n\n```bash\nBUGHERD_API_KEY=xxx bun run inspector\n```\n\n### Build for production:\n\n```bash\nbun run build\n```\n\n## API Rate Limits\n\nBugHerd allows an average of 60 requests per minute with bursts of up to 10 in quick succession. The server handles rate limiting errors gracefully.\n\n## License\n\nMIT\n\n## Author\n\n[Berckan Guerrero](https://github.com/berckan)\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request.\n\n## Related\n\n- [BugHerd API Documentation](https://www.bugherd.com/api_v2)\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)\n",
  "bytes": 7175,
  "sha": "e45f780109ae2fb7f63633973fe491fbd232a850352bb2eb8e0785b54e5985e3",
  "repo_slug": "berckan/bugherd-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_berckan_bugherd_mcp_0d1d137b/readme"
}