BugHerd

You can connect BugHerd’s bug tracking capabilities to an AI assistant via an MCP server, enabling you to manage projects, tasks, comments, attachments, and webhooks directly through natural language queries and actions with consistent API coverage.

How to use

You will run the BugHerd MCP server locally or via your MCP client, then use your client to call tools that mirror BugHerd’s API. The server exposes a comprehensive set of tools for organizations, users, projects, tasks, columns, comments, attachments, and webhooks. Use these tools to list resources, create or update records, manage memberships, and configure event handling. Your conversations with the AI assistant can read data, create items, update statuses, and trigger webhooks, all through the MCP interface.

How to install

Prerequisites you need before installing are Node.js 18+ or Bun, and a BugHerd account with API access. Acquire your BugHerd API key from Settings > General Settings.

# Step 1: Install runtime dependencies
# Use Bun if you have it, otherwise npm
bun install
# or
npm install

# Step 2: Build the server
bun run build
# or
npm run build

# Step 3: Start the server locally (example)
# Ensure the API key is available as an environment variable
export BUGHERD_API_KEY=your-api-key-here
node dist/index.js

Other important setup notes

Configure your MCP client or desktop app to connect to the BugHerd MCP server using the provided stdio configuration. You will typically run the server with a node command and point the client to the built artifact, while supplying your API key as an environment variable.

Configuration and usage patterns

You can configure the MCP client with a stdio-based server entry that launches the BugHerd MCP server locally and passes the API key via environment variables. This keeps your API credentials secure and separate from your client configuration. Typical usage involves listing projects, creating tasks, updating task status, adding or removing members, and wiring webhooks for event notifications.

Security and credentials

Protect your BugHerd API key. Do not commit it to version control. Use environment variables in your MCP client configuration to inject BUGHERD_API_KEY at runtime.

Available tools

bugherd_get_organization

Fetches the organization/account details for the BugHerd account.

bugherd_list_users

List all users including members and guests.

bugherd_list_members

List only team members.

bugherd_list_guests

List only guests or clients.

bugherd_get_user_tasks

Retrieve tasks assigned to a specific user.

bugherd_get_user_projects

Retrieve projects associated with a user.

bugherd_list_projects

List all projects in the account.

bugherd_list_active_projects

List only active projects.

bugherd_get_project

Get detailed information about a specific project.

bugherd_create_project

Create a new project.

bugherd_update_project

Update project settings.

bugherd_delete_project

Permanently delete a project.

bugherd_add_member

Add a member to a project.

bugherd_add_guest

Add a guest to a project.

bugherd_list_tasks

List tasks with filters such as status, priority, and tag.

bugherd_list_feedback_tasks

List unprocessed feedback tasks.

bugherd_list_archived_tasks

List archived tasks.

bugherd_list_taskboard_tasks

List taskboard related tasks.

bugherd_get_task

Get task details with metadata.

bugherd_get_task_global

Get a task by its global ID.

bugherd_get_task_by_local_id

Get a task by its local ID.

bugherd_create_task

Create a new task.

bugherd_move_tasks

Move tasks between projects.

bugherd_update_task

Update a task's status, priority, or description.

bugherd_list_columns

List project columns (Kanban statuses).

bugherd_get_column

Get details about a column.

bugherd_create_column

Create a new column.

bugherd_update_column

Update a column's name or position.

bugherd_list_comments

List comments on a task.

bugherd_create_comment

Add a comment to a task.

bugherd_list_attachments

List attachments for a task.

bugherd_get_attachment

Get details of an attachment.

bugherd_create_attachment

Create an attachment from a URL.

bugherd_delete_attachment

Delete an attachment.

bugherd_list_webhooks

List configured webhooks.

bugherd_create_webhook

Create a webhook.

bugherd_delete_webhook

Delete a webhook.