Bugherd
BugHerd is a visual feedback and bug tracking tool for websites, allowing clients and teams to report issues directly on live sites.
Verdict
Common use cases
- Log bugs from Slack threads as BugHerd tasks
- Triage new feedback during daily standups
- Assign tasks to developers from chat
- Pull weekly bug counts for sprint reviews
- Invite clients to projects without leaving Switchy
Integration
- Vendor
- Bugherd
- Category
- productivity
- Auth
- API_KEY
- Tools
- 25
- Composio slug
bugherd
Tools
- Add Guest to Project
Tool to add a guest (client) to a project. use when you want to add an existing client by id or invite a new client by email.
- Add Member to Project
Tool to add a member to a project in bugherd. use when you need to add an existing user to a specific project.
- Create Attachment
Tool to add a new attachment to a task using an existing url. use when you have project and task ids and the external file url ready.
- Create Column
Tool to create a new column in a project. use when you need to add a custom workflow column after identifying the project id.
- Create Comment
Tool to add a new comment to a task. use when you need to record discussion or feedback on an existing task.
- Create Project
Tool to create a new project. use when you need to initialize a project after gathering its name and url. example: "create a new project named 'my website' with url 'http://www.example.com'."
- Create Task
Tool to add a new task in a project. use when you have the project id and full task details ready.
- Create Webhook
Tool to create a new webhook for real-time event notifications. use when you need to configure a callback endpoint for task or comment events. example: "create a webhook for 'task create' events to be sent to 'https://example.com/webhook'."
- Delete Projectdestructive
Tool to delete a project. use when you need to permanently remove a project and its associated data. this action cannot be undone, so confirm the project id before calling.
- List Active Projects
Tool to list all active projects in your bugherd account. use when you need to retrieve the active projects list (e.g., for syncing or reporting).
- List Attachments
Tool to list all attachments for a task. use when you need to retrieve file attachments after fetching task details.
- List Columns
Tool to list all columns for a project. use when you need the full set of default and custom columns for a project.
- List Projects
Tool to list all projects in your account. use after setting up valid api credentials.
- List Users
Tool to list all users in your account. use after authenticating to fetch the current user roster. supports pagination via the `page` parameter.
- List Webhooks
Tool to list all installed webhooks. use when you need to audit or verify existing webhooks after setup.
- Show Attachment
Tool to retrieve details of a specific attachment. use after you have project id, task id, and attachment id to get filename, url, and timestamps.
- Show Column
Tool to show details of a specific column. use when you need metadata for a particular column within a project.
- Show Organization
Tool to retrieve your bugherd organization details. use after authenticating to fetch account metadata.
- Show Project
Tool to show details for a specific project. use when you have the project id and need to retrieve its metadata.
- Show User Projects
Tool to list all projects a specific user has access to. use after obtaining the user's id.
- Show User Tasks
Tool to list tasks created or assigned to a specific user. use when you have a user's id and need their tasks. example: list tasks for user 123.
- Update Column
Tool to update a column in a project. use when you have the project and column ids and need to rename a column. use after confirming the correct ids.
- Update Project
Tool to update settings for an existing project. use when you have the project id and need to change its configuration.
- Update Task
Tool to update a task in a project. use after confirming the project and task ids.
- Upload Attachment
Tool to upload a new attachment and add it to a specific task. use when you have binary file content ready and need to attach it to a bugherd task.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find BugHerd in the MCP directory and click Connect. 3. Log into your BugHerd account and go to Settings > API to generate a new API key. 4. Copy the key and paste it into the Switchy prompt that appears. 5. Click Authorize to complete the connection. 6. Open any Space in Switchy and type '@BugHerd list my projects' to confirm the integration works. 7. If you see your project list, the connection is live — you can now create tasks, add comments, invite team members, and pull reports by @mentioning BugHerd in any message. 8. To test task creation, try '@BugHerd create a task in project [ID] called Test Bug with priority high' and check your BugHerd dashboard to verify it appears.
What teammates see: by default, memories from Bugherd are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List Open Tasks
@BugHerd show me all open tasks in project 12345 sorted by priorityOpen in a Space →
Create Bug from Description
@BugHerd create a high-priority task in project 12345 called 'Login button unresponsive on mobile' and assign it to user 678Open in a Space →
Add Client Feedback
@BugHerd add a comment to task 98765 saying 'Client confirmed this is blocking launch'Open in a Space →
Invite Guest to Project
@BugHerd invite guest@clientdomain.com to project 12345 as a guest userOpen in a Space →
Weekly Bug Summary
@BugHerd give me a summary of task counts by status for project 12345 this weekOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@bugherd show me all open tasks in the 'Homepage Redesign' project grouped by priority
Found 23 open tasks in Homepage Redesign. High priority (7 tasks): 'Hero image not loading on mobile', 'CTA button color contrast fails WCAG', 'Navigation menu overlaps logo at 768px'. Medium priority (11 tasks): 'Footer social icons need hover states', 'About page copy needs legal review'. Low priority (5 tasks): 'Consider adding animation to scroll indicator'. This is an illustrative example showing how the MCP retrieves and organizes task data by priority level.
This example demonstrates read-heavy task querying and AI-powered grouping. Requires API key with project read access. The MCP fetches raw task data; the AI handles the priority-based organization and summarization. Useful for daily standups or sprint planning when you need a quick overview of what's blocking the team.
@bugherd create a task in the 'Mobile App' project: critical bug where login fails after password reset, assign to Sarah Chen
Created task #847 in Mobile App project: 'Critical bug where login fails after password reset'. Assigned to Sarah Chen (user ID: 12034). Status set to 'To Do', priority marked as Critical. Task URL: bugherd.com/projects/5621/tasks/847. This illustrative example shows the MCP's response after successfully creating and assigning a new task with metadata.
This example showcases the write-action workflow for task creation. Requires API key with task creation permissions and knowledge of valid project IDs and member names. The MCP handles assignment lookup by name, but if 'Sarah Chen' doesn't exist in that project, creation succeeds but assignment fails silently—always verify team membership first.
@bugherd review all comments on tasks tagged 'accessibility' from the last week and draft a summary for our compliance report
Reviewed 34 comments across 12 accessibility-tagged tasks. Key themes: 8 comments flagged color contrast issues (WCAG 2.1 AA failures on buttons and form labels), 6 discussed screen reader compatibility for the new carousel component, 4 requested alt text additions for product images. Recommended actions: Audit button styles against contrast checker, test carousel with NVDA and JAWS, create alt text writing guide for content team. This illustrative summary synthesizes comment threads into actionable compliance insights.
This example highlights synthesis capabilities—the MCP retrieves comments and task metadata, while the AI extracts patterns and generates the compliance narrative. Requires read access to tasks and comments. BugHerd's API doesn't natively filter by tag date ranges, so the MCP may fetch broader data and let the AI filter by timestamp. Useful for weekly reporting or audit prep.
Use-case deep-dives
When Bugherd wins for agency client handoffs
A 6-person design agency runs three active client sites and needs a single place where clients can flag bugs without learning Jira. Bugherd is the right call here because the guest-add tool lets you onboard clients by email in under a minute, and the visual feedback layer means clients click-and-comment directly on staging URLs. The create-task and create-comment tools give your team structured threads without forcing clients into a ticketing system. The threshold: if your clients need to track feature requests or roadmap items beyond bugs, Bugherd's task model gets limiting fast—you'll want a fuller project tool. But for pure QA handoff at agency scale, the API-key auth and 25-tool scope cover sprint-to-sprint feedback loops without the client-onboarding friction of Linear or Asana.
Bugherd for final-mile bug sweeps before ship
A 4-person product team is two weeks from launch and needs to catalog every visual glitch and copy typo across staging. Bugherd is ideal for this sprint because the create-task tool captures screenshots and browser context automatically, and the create-column tool lets you map a custom triage flow (New → Confirmed → Fixed → Verified) without admin overhead. The webhook tool means Slack gets pinged when QA marks a task verified, closing the loop in real time. The trade-off: Bugherd doesn't integrate with your Git workflow, so if you need tasks to auto-close on merge or link to PRs, you'll spend time manually syncing. For a two-week QA blitz where speed beats process, the visual-first model and 25-tool API coverage make Bugherd faster than retrofitting GitHub Issues with screenshot tooling.
When Bugherd bridges support and engineering
A 10-person SaaS startup uses Intercom for support but needs a way to escalate bug reports to engineering without losing the customer's exact repro steps. Bugherd works here because the create-task tool preserves the original screenshot and URL context, and the add-member tool lets you loop in the right engineer without a handoff meeting. The create-attachment tool means you can pull in screen recordings or logs from external storage after the fact. The boundary: if your support volume is over 50 tickets a week, manually creating Bugherd tasks from Intercom threads becomes a bottleneck—you'll want a native integration or a heavier automation layer. For teams under that threshold, the API-key setup and structured comment threads give you a lightweight escalation path that doesn't require engineering to monitor a second support queue.
Frequently asked
What does the BugHerd MCP let me do in Switchy?
The BugHerd MCP connects your visual feedback and bug tracking workspace to Switchy's AI agents. Your team can create tasks, add comments, attach files, manage project members, and set up custom workflow columns — all through natural language. Agents see your project structure and can route feedback directly into BugHerd without switching tools.
Do I need admin access to connect BugHerd?
You need a BugHerd API key, which typically requires account owner or admin permissions to generate. The key grants full access to your organization's projects, tasks, and members, so only connect it if you're comfortable giving Switchy that scope. Standard members usually can't create API keys in BugHerd's settings.
Can the MCP create tasks with attachments from URLs?
Yes. The MCP includes separate tools for creating tasks and adding attachments via external URLs. You'll create the task first to get its ID, then attach files by referencing that ID and the file's public URL. It won't upload files directly from your local machine — the attachment must already be hosted somewhere accessible.
How is this different from just using BugHerd's web interface?
The MCP lets AI agents act on BugHerd data without you opening the app. If your team already captures feedback in Slack or email, an agent can parse it and file tasks automatically. You lose BugHerd's visual point-and-click feedback tool, but gain the ability to batch-create tasks or sync feedback from other tools programmatically.
Who on my team should connect the BugHerd integration?
Whoever owns your BugHerd account or has API key access. Since the key grants organization-wide permissions, connect it from a shared Switchy workspace rather than a personal one. If multiple people need to trigger BugHerd actions through Switchy, they'll all use the same connected integration — BugHerd doesn't support per-user OAuth.