Honeybadger — Claude Code MCP server: what it does, how to install
Brings Honeybadger error inspection, log exploration, and cron monitoring directly to your coding assistant. Handles incident triage without switching windows.
Open on GitHubWhat Honeybadger does
The integration exposes the Honeybadger API to MCP-compatible development tools. Assistants can inspect crash details, query service logs, and watch scheduled tasks. The hosted endpoint handles authorization via OAuth at https://mcp.honeybadger.io/mcp or the EU address https://eu-mcp.honeybadger.io/mcp. It requires no local container.
For local setups over stdio, the project provides a Go binary and a Docker image (ghcr.io/honeybadger-io/honeybadger-mcp-server:1.5.1). Running locally requires an API token starting with hbu_ or hba_ exported as HONEYBADGER_PERSONAL_AUTH_TOKEN.
The server defaults to HONEYBADGER_READ_ONLY=true, blocking destructive actions such as deleting projects. Running the HTTP transport independently also demands a 32-character string in MCP_CONFIRM_SECRET to sign deletions, without which the process refuses to boot.
What it helps with
- inspect recent crash traces and exception details
- track scheduled cron check-ins and failures
- search application log events directly from editor chat
- review incident alerts across monitored projects
Example prompts for the agent
- Show the latest unresolved exceptions reported in Honeybadger.
- Check whether our scheduled background cron jobs finished successfully.
- Pull the recent error logs matching status 500 from Honeybadger.
How to install Honeybadger
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http mcp https://{host}.honeybadger.io/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add honeybadger --url https://{host}.honeybadger.io/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"honeybadger": {
"url": "https://{host}.honeybadger.io/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"honeybadger": {
"type": "http",
"url": "https://{host}.honeybadger.io/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http honeybadger https://{host}.honeybadger.io/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Honeybadger
How to install Honeybadger in Claude Code?
Run claude mcp add --transport http honeybadger https://{host}.honeybadger.io/mcp, using mcp for the US cluster or eu-mcp for Europe. Browser OAuth completes the setup.
What does the Honeybadger MCP server do?
It lets coding assistants retrieve Honeybadger monitoring telemetry. You can investigate errors, inspect logs, and check cron schedules right within your terminal.
Why are delete operations rejected by default?
The HONEYBADGER_READ_ONLY setting defaults to true to guard production resources. Destructive actions stay disabled until you explicitly adjust that environment flag.
