honeycomb

The Honeycomb MCP Server bridges Claude AI with the Honeycomb observability platform. It exposes a collection of tools that let Claude authenticate with Honeycomb, list and inspect datasets, manage columns and queries, create and run queries to retrieve results, and interact with boards and dataset definitions. This enables Claude to perform common Honeycomb operations—such as listing datasets, inspecting a specific dataset, creating and executing queries, retrieving results, and managing definitions or boards—through the MCP interface. The server is designed to be used via Claude or any MCP-enabled client, with the tooling names clearly indicating their Honeycomb function (for example honeycomb_datasets_list, honeycomb_query_create, honeycomb_query_result_get, etc.).

Prerequisites:

• Node.js 18 or higher
• npm installed
• A Honeycomb API key with appropriate permissions

Installation steps:

1. Install the MCP server globally using npm (or use npx directly):

# Install globally
npm install -g @kajirita2002/honeycomb-mcp-server

# Or run directly with npx
npx @kajirita2002/honeycomb-mcp-server

2. Set the required environment variable for Honeycomb authentication:

export HONEYCOMB_API_KEY="your_honeycomb_api_key"

3. Start the MCP server (if not using npx directly):

npm start

4. Configure mcp_config.json in your MCP setup to point to the server, for example using the provided mcp_config snippet in this project.

Environment variables: HONEYCOMB_API_KEY is required to authenticate with Honeycomb. If you rotate API keys, update the environment variable accordingly. Common issues include missing API keys, network access to Honeycomb, and ensuring the npm package is the latest version. The server exposes a range of tools for datasets, columns, queries, results, and boards; use the documentation strings of each tool to understand required inputs. If you encounter rate limits, consider batching requests or increasing timeouts where supported. When using npx, ensure your environment allows executing remote npm packages.