Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to BugHerd

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the BugHerd connection

    In AgentKit > Connections, create a BugHerd connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • bugherd_attachment_getGet one attachment of a task.Read-only

    Get 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-only

    List 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-only

    Get 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-only

    List 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-only

    List 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-only

    List 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-only

    List 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-only

    Get 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.