The BugHerd MCP server connects AI clients like Claude, Cursor, and ChatGPT directly to your BugHerd projects - so they can read client feedback, act on tasks, and close the loop without leaving your editor.

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

What data does the BugHerd MCP share per task?

Everything you capture in BugHerd is shared with your agent, including but not limited to:

Title and description
Status (which board column it's in, e.g. Backlog, To Do, Done)
Severity (critical, important, normal, minor)
Screenshot or screen recording
URL of the page where the issue was found
CSS selector for the exact HTML element with the bug
Browser and OS info (browser version, screen resolution, window size, user agent)
Assignees (name, email)
Due date
Tags
Whether it's visible to clients
Comments

Authentication & Permissions

BugHerd MCP uses secure OAuth authentication.

When connecting a client:

You’ll be redirected to the BugHerd authorization page
You’ll select the organization you want the client to access
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:

Go to BugHerd Settings
In the left sidebar, click MCP Access Tokens

Or open:

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

From this page, you can:

View active MCP tokens
Revoke access tokens
Disconnect previously authorized clients

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

Available BugHerd MCP Tools

BugHerd MCP currently provides the following tools:

Tool	Description
`list_projects`	List projects you can access
`get_project_details`	Retrieve details for a specific project
`list_my_tasks`	View tasks assigned to or created by you
`list_all_tasks`	View tasks across your projects
`list_project_tasks`	View tasks for a specific project
`get_task_details`	Retrieve full details for a specific task as documented here.
`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
`prepare_attachment_upload`	Generate secure upload URLs for task attachments
`update_task_attachments`	Add, remove, or replace task attachments
`update_task_assignees`	Add or remove task assignees
`update_task_tags`	Add, remove, or update task tags
`prepare_asset_upload`	Generate secure upload URLs for project assets
`update_project_assets`	Add, update, or manage project assets such as images and PDFs
`update_project_sites`	Add, update, or remove tracked project website URLs
`update_project_users`	Add or remove users from a project