Skip to main content

Getting Started with the BugHerd MCP server

K
Written by Kriztin Abellon

The BugHerd MCP (Model Context Protocol) server allows AI clients to securely connect to BugHerd so you can access projects, tasks, comments, and project activity directly from your AI workflows.

Once connected, your AI client can interact with BugHerd using natural language.

Supported Clients

To set up the BugHerd MCP server, follow the setup instructions for your preferred client:

Note: MCP support and setup steps may vary depending on the client and version you are using.

What You Can Do with BugHerd MCP

Once connected, you can use BugHerd directly from your AI client to:

  • View projects and project details

  • View your assigned tasks and team workloads

  • Search and review tasks across projects

  • Create and update tasks

  • Add comments to tasks

  • Create and manage projects

  • Summarize project progress and activity

  • Help organize and triage work faster

Authentication & Permissions

BugHerd MCP uses secure OAuth authentication.

When connecting a client:

  1. You’ll be redirected to the BugHerd authorization page

  2. You’ll select the organization you want the client to access

  3. You’ll approve the connection

The selected organization determines which BugHerd data the client can access.

Your access and permissions always reflect your existing BugHerd permissions.

Revoke MCP Access Tokens

You can revoke access to any connected MCP client at any time.

To manage or revoke tokens:

  1. Go to BugHerd Settings

  2. In the left sidebar, click MCP Access Tokens

  3. Or open:

    https://www.bugherd.com/settings/mcp-access-tokens

From this page, you can:

  • View active MCP connections

  • Revoke access tokens

  • Disconnect previously authorized clients

Revoking a token immediately removes that client’s access to BugHerd.

Available MCP Tools

BugHerd MCP currently provides the following tools:

Tool

Description

list_projects

List projects the authenticated user can access

get_project_details

Retrieve details for a specific project

list_my_tasks

View tasks assigned to or created by the authenticated user

list_all_tasks

View tasks across accessible projects

list_project_tasks

View tasks for a specific project

get_task_details

Retrieve full details for a specific task

create_task

Create a new task in a project

update_task

Update task details

add_comment

Add comments to tasks

create_project

Create a new BugHerd project

update_project

Update project settings

Additional MCP tools and capabilities may be added over time.

💬 Have questions? We're here to help

Reach out in-app or email us at [email protected] and we’ll get you sorted.

Did this answer your question?