Use this guide to connect BugHerd to Codex 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 Codex CLI or IDE
How to install
On your computer device, navigate to the ~/.codex/config.toml file and paste in the following:
[mcp_servers.bugherd]
enabled = true
url = "https://mcp.bugherd.com/mcp"(this path may be hidden on your device. Press '⇧⌘.' to show hidden files on a mac device)
Save the file and close Codex in your Terminal, so that it reloads the MCP server list.
After closing Codex, type this into the Terminal:
codex mcp login 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 Codex CLI can access.
After authenticating, you will then be able to connect to the BugHerd MCP via Codex CLI.
Verify Your Connection
Restart the Codex CLI and try this prompt:
“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.