Use this guide to connect BugHerd to the Gemini CLI, so you can access projects, tasks, and comments directly from your AI workflows.
Prerequisites
Before connecting, ensure:
You have a BugHerd account and You have access to at least one BugHerd organization
You are logged into the Gemini CLI
How to install
On your computer device, navigate to the ~/.codex/settings.json file and paste in the following:
"mcpServers": {
"bugherd": {
"url": "https://mcp.bugherd.com/mcp"
}
}(this path may be hidden on your device. Press '⇧⌘.' to show hidden files on a mac device)
Close and restart the Gemini CLI in your Terminal.
After restarting Gemini CLI, type this into the Terminal:
/mcp auth bugherd
You’ll be redirected to the BugHerd to authenticate the connection.
Select the Organization you want to connect and click Allow
⚠️ Note: The selected organization determines what data Gemini CLI can access.
After authenticating, you will then be able to connect to the BugHerd MCP via Gemini CLI.
Verify Your Connection
Try this prompt in the Gemini CLI:
“List my BugHerd projects”
If you see results, the connection is working.
What you can do with BugHerd's MCP
Once connected, you can:
View projects
View your assigned tasks
Explore project details
View tasks across projects
Add comments to tasks
Need help? Contact [email protected] or start a chat from the app.