---
title: "Bugherd integration for LuumenAI"
url: "https://www.luumen.ai/integrations/bugherd/"
entity: SoftwareIntegration
category: "Project management"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Bugherd integration for LuumenAI

Read BugHerd projects and tasks, then file the fix as an approved step

## What LuumenAI can do with Bugherd

LuumenAI connects to Bugherd with an API token and exposes 26 tools (13 read-only · 12 write · 1 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 26 tools (13 read-only · 12 write · 1 destructive)
- Plan: available on all plans
- Category: Project management

## About Bugherd with LuumenAI

BugHerd collects issues reported straight from a live site, which means the backlog fills up faster than anyone reads it. Connect it and Luumen can list projects, walk the tasks on a board, and check who has access — all without leaving the terminal. When something needs to be filed, commented on, or assigned, that change is previewed and approved first.

## Example tools

Read-only (13 in total):

- `BUGHERD_LIST_ACTIVE_PROJECTS` — List all active projects in your BugHerd account.
- `BUGHERD_LIST_ATTACHMENTS` — List all attachments for a task.
- `BUGHERD_LIST_COLUMNS` — List all columns for a project.
- `BUGHERD_LIST_PROJECTS` — Retrieves a paginated list of all projects in your BugHerd account.
- `BUGHERD_LIST_PROJECT_TASKS` — List tasks within a specific BugHerd project with optional server-side filters (status/column, assignee, tag, priority, date filters) and pagination.
- `BUGHERD_LIST_USERS` — List all users in your account.
- `BUGHERD_LIST_WEBHOOKS` — List all installed webhooks.
- `BUGHERD_SHOW_ATTACHMENT` — Retrieve details of a specific attachment.

Write and destructive (13 in total, approval required by default):

- `BUGHERD_ADD_GUEST_TO_PROJECT` — Add a guest (client) to a project.
- `BUGHERD_ADD_MEMBER_TO_PROJECT` — Add a member to a project in BugHerd.
- `BUGHERD_CREATE_ATTACHMENT` — Add a new attachment to a task using an existing URL.
- `BUGHERD_CREATE_COLUMN` — Create a new column in a project.
- `BUGHERD_CREATE_COMMENT` — Add a new comment to a task.
- `BUGHERD_CREATE_PROJECT` — Create a new project.
- `BUGHERD_CREATE_TASK` — Add a new task in a project.
- `BUGHERD_CREATE_WEBHOOK` — Create a new webhook for real-time event notifications.

## Frequently asked questions

### How does LuumenAI connect to Bugherd?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Bugherd on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Bugherd — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/bugherd/