The BugHerd connector lets your AI agent act in each user's BugHerd account. Each user connects their own BugHerd API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 37 tools.
- Tools
- 37
- What they doRead · write · destructive
- 22 · 12 · 322 read12 write3 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the BugHerd connection
In AgentKit > Connections, create a BugHerd connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toolbugherd_attachment_getGet one attachment of a task.Read-onlyGet Attachment
Get one attachment of a task. Returns its file name and download URL. Use bugherd_attachment_get when you know the attachment ID.
Inputs
attachment_idintegerrequired- Attachment ID, from bugherd_attachments_list. Example: 3141
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
task_idintegerrequired- Task ID (the global task ID returned by the task list tools). Example: 987654
bugherd_attachments_listList the files attached to a task.Read-onlyList Attachments
List the files attached to a task. Returns each attachment's ID, file name and URL. Use bugherd_attachments_list to get screenshots or files reported with a task.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
task_idintegerrequired- Task ID (the global task ID returned by the task list tools). Example: 987654
bugherd_column_getGet one board column.Read-onlyGet Column
Get one board column. Returns the column's ID, name and position. Use bugherd_column_get when you know the column ID.
Inputs
column_idintegerrequired- Column ID, from bugherd_columns_list. Example: 55
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
bugherd_columns_listList a project's board columns, built-in (backlog, todo, doing, done) and custom.Read-onlyList Columns
List a project's board columns, built-in (backlog, todo, doing, done) and custom. Returns each column's ID, name and position. Use bugherd_columns_list to find valid status values for tasks.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
bugherd_comments_listList the comments on a task.Read-onlyList Comments
List the comments on a task. Returns each comment's text, author, privacy and time. Use bugherd_comments_list to read a task's discussion.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
task_idintegerrequired- Task ID (the global task ID returned by the task list tools). Example: 987654
bugherd_guests_listList the organization's guests (clients invited to give feedback on projects).Read-onlyList Guests
List the organization's guests (clients invited to give feedback on projects). Returns a page of guests with ID, name and email. Use bugherd_guests_list to see external reviewers.
Inputs
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
bugherd_members_listList the organization's team members (not guests).Read-onlyList Members
List the organization's team members (not guests). Returns a page of members with ID, name and email. Use bugherd_members_list to find people to assign tasks to.
Inputs
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
bugherd_organization_getGet your BugHerd organization's details.Read-onlyGet Organization
Get your BugHerd organization's details. Returns the organization's ID and name. Use bugherd_organization_get to check the connection.
Inputs
This tool takes no inputs.
bugherd_project_getGet one project with its members, guests and columns.Read-onlyGet Project
Get one project with its members, guests and columns. Returns the project's name, website URL, settings, members, guests and column configuration. Use bugherd_project_get to see who is on a project and its board columns.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
bugherd_projects_active_listList only active projects.Read-onlyList Active Projects
List only active projects. Returns a page of active projects. Use bugherd_projects_active_list for projects currently collecting feedback.
Inputs
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
bugherd_projects_listList all projects in the organization, active and inactive.Read-onlyList Projects
List all projects in the organization, active and inactive. Returns a page of projects with ID, name, website URL and status. Use bugherd_projects_list to find a project ID. Use bugherd_projects_active_list for active projects only.
Inputs
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
bugherd_task_getGet one task with full details, including the page URL, browser and screen info and screenshot.Read-onlyGet Task
Get one task with full details, including the page URL, browser and screen info and screenshot. Returns the task's description, status, priority, tags, assignees, requester, metadata and screenshot URL. Use bugherd_task_get when you have the project and task IDs. Use bugherd_task_get_global with only a task ID, or bugherd_task_get_by_local_id with the #number.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
task_idintegerrequired- Task ID (the global task ID returned by the task list tools). Example: 987654
bugherd_task_get_by_local_idGet a task by its project task number (the #42 shown in BugHerd).Read-onlyGet Task by Number
Get a task by its project task number (the #42 shown in BugHerd). Returns the task's details, including its global ID. Use bugherd_task_get_by_local_id when you have the number from the UI or a link.
Inputs
local_task_idintegerrequired- Project-scoped task number, as shown in the UI (for example 42). Example: 42
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
bugherd_task_get_globalGet a task by its global ID without knowing its project.Read-onlyGet Task by ID
Get a task by its global ID without knowing its project. Returns the task's details and project. Use bugherd_task_get_global when you only have a task ID.
Inputs
task_idintegerrequired- Task ID (the global task ID returned by the task list tools). Example: 987654
bugherd_tasks_archive_listList a project's closed or archived tasks.Read-onlyList Archived Tasks
List a project's closed or archived tasks. Returns a page of tasks. Use bugherd_tasks_archive_list to review finished work.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
bugherd_tasks_feedback_listList the tasks waiting in a project's Feedback panel (new, unprocessed reports).Read-onlyList Feedback Tasks
List the tasks waiting in a project's Feedback panel (new, unprocessed reports). Returns a page of tasks. Use bugherd_tasks_feedback_list to triage incoming bug reports.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
bugherd_tasks_listList a project's tasks, filtered by status, priority, tag, assignee, external ID or date.Read-onlyList Tasks
List a project's tasks, filtered by status, priority, tag, assignee, external ID or date. Returns a page of tasks with ID, local ID, description, status, priority, tags and assignees. Use bugherd_tasks_list to search a project. Use bugherd_tasks_feedback_list, bugherd_tasks_taskboard_list or bugherd_tasks_archive_list for one area of the board.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
assigned_to_idinteger- Only tasks assigned to this user ID. Example: 4321
created_sincestring- Only tasks created after this ISO 8601 time. Example: 2026-11-01T00:00:00Z
external_idstring- Only the task with this external ID. Example: JIRA-123
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
prioritystring- Only tasks with this priority. One of: not set, critical, important, normal, minor. Example: criticalone of
not setcriticalimportantnormalminor statusstring- Only tasks in this status or column, for example backlog, todo, doing or done. Example: todo
tagstring- Only tasks with this tag. Example: homepage
updated_sincestring- Only tasks updated after this ISO 8601 time. Example: 2026-11-01T00:00:00Z
bugherd_tasks_taskboard_listList all active (not archived) tasks on a project's taskboard.Read-onlyList Taskboard Tasks
List all active (not archived) tasks on a project's taskboard. Returns a page of tasks. Use bugherd_tasks_taskboard_list to see current work.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
bugherd_user_projects_listList the projects a user belongs to.Read-onlyList User Projects
List the projects a user belongs to. Returns a page of projects. Use bugherd_user_projects_list to see where a user has access.
Inputs
user_idintegerrequired- User ID, from bugherd_users_list. Example: 4321
created_sincestring- Only projects created after this ISO 8601 time. Example: 2026-01-01T00:00:00Z
is_activeboolean- true for active projects only, false for inactive only. Example: true
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
bugherd_user_tasks_listList the tasks assigned to a user across all projects, optionally filtered by date, priority, tag or assignee.Read-onlyList User Tasks
List the tasks assigned to a user across all projects, optionally filtered by date, priority, tag or assignee. Returns a page of tasks. Use bugherd_user_tasks_list for someone's workload. Use bugherd_tasks_list for one project.
Inputs
user_idintegerrequired- User ID, from bugherd_users_list. Example: 4321
assigned_to_idinteger- Only tasks assigned to this user ID. Example: 4321
created_sincestring- Only tasks created after this ISO 8601 time. Example: 2026-11-01T00:00:00Z
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
prioritystring- Only tasks with this priority. One of: not set, critical, important, normal, minor. Example: criticalone of
not setcriticalimportantnormalminor tagstring- Only tasks with this tag. Example: homepage
updated_sincestring- Only tasks updated after this ISO 8601 time. Example: 2026-11-01T00:00:00Z
bugherd_users_listList all users in the organization, both team members and guests (clients).Read-onlyList Users
List all users in the organization, both team members and guests (clients). Returns a page of users with ID, name, email and whether each is a guest. Use bugherd_users_list to find a user ID. Use bugherd_members_list or bugherd_guests_list for one kind only.
Inputs
pageinteger- Page number, starting at 1; each page holds up to 100 records and an empty page means the end. Example: 1
updated_sincestring- Only users updated after this ISO 8601 time. Example: 2026-11-01T00:00:00Z
bugherd_webhooks_listList the organization's webhooks with delivery statistics and errors.Read-onlyList Webhooks
List the organization's webhooks with delivery statistics and errors. Returns each webhook's ID, event, target URL, project and delivery stats. Use bugherd_webhooks_list to check which events are sent where.
Inputs
This tool takes no inputs.
bugherd_attachment_createAttach a file to a task from a public URL; BugHerd downloads and stores a copy.WriteAttach File from URL
Attach a file to a task from a public URL; BugHerd downloads and stores a copy. Returns the created attachment. Use bugherd_attachment_create to add a screenshot or log that is already online.
Inputs
file_namestringrequired- File name to store it as. Example: error-log.txt
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
task_idintegerrequired- Task ID (the global task ID returned by the task list tools). Example: 987654
urlstringrequired- Publicly reachable URL of the file. Example: https://example.com/files/error-log.txt
bugherd_column_createAdd a custom column to the end of a project's board.WriteCreate Column
Add a custom column to the end of a project's board. Returns the created column. Use bugherd_column_create for a new workflow stage such as QA.
Inputs
namestringrequired- Column name. Example: QA
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
bugherd_column_updateRename a custom column.WriteRename Column
Rename a custom column. Returns the updated column. Use bugherd_column_update to rename a stage.
- Idempotent
Inputs
column_idintegerrequired- Column ID, from bugherd_columns_list. Example: 55
namestringrequired- New column name. Example: Ready for QA
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
bugherd_comment_createAdd a comment to a task, optionally private to team members.WriteCreate Comment
Add a comment to a task, optionally private to team members. Returns the created comment. Use bugherd_comment_create to reply to a reporter or add notes; set is_private to hide it from guests.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
task_idintegerrequired- Task ID (the global task ID returned by the task list tools). Example: 987654
textstringrequired- Comment text. Example: Fixed in build 1.4.2, please re-check.
emailstring- Email of the commenter, as an alternative to user_id. Example: dev@yourcompany.com
is_privateboolean- true makes the comment visible to team members only. Example: false
user_idinteger- User ID of the commenter. Example: 4321
bugherd_project_createCreate a project for a website; it starts with no members or guests.WriteCreate Project
Create a project for a website; it starts with no members or guests. Returns the created project with its ID. Use bugherd_project_create for a new site, then add people with bugherd_project_member_add and bugherd_project_guest_add.
Inputs
devurlstringrequired- Main website URL the project collects feedback on. Example: https://staging.acme.com
namestringrequired- Project name. Example: Acme website redesign
guests_see_guestsboolean- Let guests see other guests' feedback. Example: false
is_activeboolean- Whether the project is active. Example: true
is_publicboolean- Enable public feedback, so anyone visiting the site can report issues. Example: false
bugherd_project_guest_addAdd a guest (client) to a project by user ID, or invite one by email.WriteAdd Project Guest
Add a guest (client) to a project by user ID, or invite one by email. Returns the result. An email invitation is sent to new guests. Use bugherd_project_guest_add to let a client report feedback on a project.
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
emailstring- Email to invite as a new guest; give this or user_id. Example: client@acme.com
user_idinteger- Existing user's ID; give this or email. Example: 5678
bugherd_project_member_addAdd an existing organization member to a project.WriteAdd Project Member
Add an existing organization member to a project. Returns the result. Use bugherd_project_member_add to give a teammate access. Use bugherd_project_guest_add for clients.
- Idempotent
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
user_idintegerrequired- Member's user ID, from bugherd_members_list. Example: 4321
bugherd_project_updateUpdate a project's name, website URL or settings; only the fields you send change.WriteUpdate Project
Update a project's name, website URL or settings; only the fields you send change. Returns the updated project. Use bugherd_project_update to rename, deactivate or change sharing.
- Idempotent
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
devurlstring- Main website URL. Example: https://www.acme.com
guests_see_guestsboolean- Let guests see other guests' feedback. Example: false
has_custom_columnsboolean- Whether the project uses custom board columns. Example: true
is_activeboolean- Whether the project is active. Example: true
is_publicboolean- Enable public feedback, so anyone visiting the site can report issues. Example: false
namestring- Project name. Example: Acme website (live)
bugherd_task_createCreate a task (bug or feedback item) in a project; without a status it goes to the Feedback panel.WriteCreate Task
Create a task (bug or feedback item) in a project; without a status it goes to the Feedback panel. Returns the created task with its ID and local number. Use bugherd_task_create to log an issue. Use bugherd_task_update to change it later.
Inputs
descriptionstringrequired- What the issue is. Example: Header logo is blurry on retina screens
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
assigned_to_emailstring- Email of a project member to assign. Example: dev@yourcompany.com
assigned_to_idinteger- User ID to assign; must be a project member. Example: 4321
external_idstring- Your ID for the task in another system. Example: JIRA-123
prioritystring- Priority. One of: not set, critical, important, normal, minor. Example: importantone of
not setcriticalimportantnormalminor requester_emailstring- Email of the person reporting it (any email). Example: client@acme.com
requester_idinteger- User ID of the person reporting it. Example: 4321
statusstring- Column to put it in: backlog, todo, doing, done or a custom column name; leave empty for the Feedback panel. Example: todo
tag_namesarray- Tags to add. Example: ["homepage", "design"]
bugherd_task_updateUpdate a task's description, priority, status (column), assignees, tags or external ID; only the fields you send change.WriteUpdate Task
Update a task's description, priority, status (column), assignees, tags or external ID; only the fields you send change. Returns the updated task. Use bugherd_task_update to move a task across the board (status todo, doing, done, a custom column or feedback), reassign it or tag it.
- Idempotent
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
task_idintegerrequired- Task ID (the global task ID returned by the task list tools). Example: 987654
assigned_to_emailstring- Email of a project member to assign. Example: dev@yourcompany.com
assigned_to_idinteger- User ID to assign. Example: 4321
descriptionstring- New description. Example: Header logo is blurry on retina screens (iPhone 15)
external_idstring- Your ID for the task in another system. Example: JIRA-123
prioritystring- Priority. One of: not set, critical, important, normal, minor. Example: criticalone of
not setcriticalimportantnormalminor sitestring- Site the task belongs to. Example: https://staging.acme.com
statusstring- Column: backlog, todo, doing, done, a custom column name, or feedback to send it back to the Feedback panel. Example: doing
tag_namesarray- Tags; replaces the task's tags. Example: ["homepage"]
unassign_userinteger- User ID to remove from the assignees. Example: 8765
updater_emailstring- Email of the user to credit with the change in the audit trail. Example: dev@yourcompany.com
urlstring- Page path or URL the task is on. Example: /pricing
bugherd_tasks_moveMove tasks from one project to another; task IDs stay the same.WriteMove Tasks to Project
Move tasks from one project to another; task IDs stay the same. Returns the result. Use bugherd_tasks_move to re-file issues reported on the wrong project. task_ids are the project task numbers (local IDs), not global IDs.
Inputs
destination_project_idintegerrequired- Project to move the tasks into. Example: 67890
project_idintegerrequired- Source project ID. Example: 12345
task_idsarrayrequired- Project task numbers (local IDs, the #number) of the tasks to move. Example: [41, 42]
bugherd_webhook_createCreate a webhook that POSTs to a URL when an event happens, for all projects or one.WriteCreate Webhook
Create a webhook that POSTs to a URL when an event happens, for all projects or one. Returns the created webhook. A 410 Gone response from your URL removes the webhook automatically. Use bugherd_webhook_create to sync new tasks or comments into another system.
Inputs
eventstringrequired- Event to send. One of: project_create, task_create, task_update, comment, task_destroy. Example: task_createone of
project_createtask_createtask_updatecommenttask_destroy target_urlstringrequired- URL that receives the events. Example: https://example.com/hooks/bugherd
project_idinteger- Only events from this project; leave empty for all projects. Example: 12345
bugherd_attachment_deleteDelete an attachment from a task.DestructiveDelete Attachment
Delete an attachment from a task. This cannot be undone. Returns an empty response on success. Use bugherd_attachment_delete to remove a file.
- Idempotent
Inputs
attachment_idintegerrequired- Attachment ID, from bugherd_attachments_list. Example: 3141
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
task_idintegerrequired- Task ID (the global task ID returned by the task list tools). Example: 987654
bugherd_project_deleteDelete a project with all its tasks, comments and attachments.DestructiveDelete Project
Delete a project with all its tasks, comments and attachments. This cannot be undone. Returns an empty response on success. Use bugherd_project_delete only to remove a project permanently. Use bugherd_project_update with is_active false to archive it.
- Idempotent
Inputs
project_idintegerrequired- Project ID, from bugherd_projects_list. Example: 12345
bugherd_webhook_deleteDelete a webhook; BugHerd stops sending its events immediately.DestructiveDelete Webhook
Delete a webhook; BugHerd stops sending its events immediately. Returns an empty response on success. Use bugherd_webhook_delete to stop an integration.
- Idempotent
Inputs
webhook_idintegerrequired- Webhook ID, from bugherd_webhooks_list. Example: 777
No tools match.