StackMCP

Set up Grafana MCP in Claude Code

Search dashboards, query datasources, manage alerts, view incidents, and interact with Grafana observability tools from your AI editor.

1

Locate the config file

Claude Code reads MCP server configuration from the following file:

~/.claude.json

Create this file if it does not already exist.

2

Add the configuration

You can configure Grafana MCP using the CLI command or by editing the config file directly.

Option A: CLI command

bash
claude mcp add grafana-mcp -e GRAFANA_URL=YOUR_GRAFANA_URL -e GRAFANA_API_KEY=YOUR_GRAFANA_API_KEY -- npx -y @leval/mcp-grafana

Option B: Config file

json
{
  "mcpServers": {
    "grafana-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@leval/mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "YOUR_GRAFANA_URL",
        "GRAFANA_API_KEY": "YOUR_GRAFANA_API_KEY"
      }
    }
  }
}
3

Set up environment variables

Grafana MCP requires the following environment variables:

GRAFANA_URLRequired

Grafana instance URL

GRAFANA_API_KEYRequired

Grafana API key or service account token

4

Verify it works

Restart Claude Code. Grafana MCP should appear in your MCP server list with 43 tools available.

This server adds approximately 22,145 tokens to your context window for tool definitions.

Set up Grafana MCP in other editors

CursorVS CodeWindsurfClaude DesktopContinue
← Back to Grafana MCP