Honeybadger MCP Server Setup Guide

This MCP server integrates Honeybadger error tracking with Cursor IDE, allowing you to fetch and analyze errors directly from your development environment.

Prerequisites

• Node.js 18+ installed
• Honeybadger account with API access
• Cursor IDE with MCP support

Installation

1. Clone the MCP Server

git clone [email protected]:vishalzambre/honeybadger-mcp.git
cd honeybadger-mcp
npm install

2. Build the Project

npm run build

3. Using as an NPM Package (Recommended)

Global Installation:

npm install -g @vishalzambre/honeybadger-mcp

Then configure it in Cursor:

{
  "mcpServers": {
    "honeybadger": {
      "command": "honeybadger-mcp",
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

Project-based Installation (Alternative):

If you prefer to manage the MCP server as a project dependency:

npm install @vishalzambre/honeybadger-mcp

In this case, the command in your Cursor mcp_servers.json would point to the local installation within your project’s node_modules:

{
  "mcpServers": {
    "honeybadger": {
      "command": "node",
      "args": ["./node_modules/@vishalzambre/honeybadger-mcp/dist/index.js"],
      "env": {
        "HONEYBADGER_API_KEY": "your_api_key_here",
        "HONEYBADGER_PROJECT_ID": "your_project_id"
      }
    }
  }
}

4. Configure Environment Variables

Create a .env file in your project root:

# Required: Your Honeybadger API key
HONEYBADGER_API_KEY=your_api_key_here

# Optional: Default project ID (can be overridden per request)
HONEYBADGER_PROJECT_ID=your_project_id

# Optional: Custom Honeybadger URL (defaults to https://app.honeybadger.io)
HONEYBADGER_BASE_URL=https://app.honeybadger.io

4. Get Your Honeybadger Credentials

1. API Key:

   • Go to https://app.honeybadger.io/users/auth_tokens
   • Create a new Personal Auth Token
   • Copy the token for your .env file

2. Project ID:

   • Go to your project in Honeybadger
   • The project ID is in the URL: https://app.honeybadger.io/projects/{PROJECT_ID}
   • Or find it in project settings

Cursor Configuration

1. Configure MCP in Cursor

Add the MCP server to your Cursor configuration. Edit your ~/.cursor/mcp_servers.json (or equivalent):

{
  "mcpServers": {
    "honeybadger": {
      "command": "node",