Grafana MCP Server

by grafanaio.github.grafana/mcp-grafanav2.0.1

Search dashboards, investigate incidents and query datasources in your Grafana instance.

3.5kDockerstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Activetoday

Install Grafana MCP server

claude mcp add grafana -e GRAFANA_URL='<grafana-url>' -e GRAFANA_SERVICE_ACCOUNT_TOKEN='<grafana-service-account-token>' -e GRAFANA_PASSWORD='<grafana-password>' -- docker run -i --rm -e GRAFANA_URL -e GRAFANA_SERVICE_ACCOUNT_TOKEN -e GRAFANA_PASSWORD docker.io/grafana/mcp-grafana:2.0.1

{
  "mcpServers": {
    "grafana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "-e",
        "GRAFANA_PASSWORD",
        "docker.io/grafana/mcp-grafana:2.0.1"
      ],
      "env": {
        "GRAFANA_URL": "<grafana-url>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<grafana-service-account-token>",
        "GRAFANA_PASSWORD": "<grafana-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "grafana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "-e",
        "GRAFANA_PASSWORD",
        "docker.io/grafana/mcp-grafana:2.0.1"
      ],
      "env": {
        "GRAFANA_URL": "<grafana-url>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<grafana-service-account-token>",
        "GRAFANA_PASSWORD": "<grafana-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "grafana": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "-e",
        "GRAFANA_PASSWORD",
        "docker.io/grafana/mcp-grafana:2.0.1"
      ],
      "env": {
        "GRAFANA_URL": "<grafana-url>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<grafana-service-account-token>",
        "GRAFANA_PASSWORD": "<grafana-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "grafana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "-e",
        "GRAFANA_PASSWORD",
        "docker.io/grafana/mcp-grafana:2.0.1"
      ],
      "env": {
        "GRAFANA_URL": "<grafana-url>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<grafana-service-account-token>",
        "GRAFANA_PASSWORD": "<grafana-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GRAFANA_URL	yes	—	URL to your Grafana instance
GRAFANA_SERVICE_ACCOUNT_TOKEN	—	yes	Service account token used to authenticate with your Grafana instance
GRAFANA_USERNAME	—	—	Username to authenticate with your Grafana instance
GRAFANA_PASSWORD	—	yes	Password to authenticate with your Grafana instance
GRAFANA_ORG_ID	—	—	Organization ID for multi-org support. Can also be set via X-Grafana-Org-Id header in SSE/streamable HTTP transports.
GRAFANA_EXTRA_HEADERS	—	—	JSON object of additional HTTP headers to send with all Grafana API requests
GRAFANA_FORWARD_HEADERS	—	—	Comma-separated list of HTTP header names to forward from the incoming request to Grafana (SSE/streamable-http only). Example: Cookie,X-Session-Id

Remote endpoints

streamable-httphttps://mcp.grafana.com/mcp

Freshness

Active — last maintenance signal today. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · today · GitHub
Latest release
2026-10-07 · 1d ago · GitHub · v2.0.2
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 3d ago · official registry · v2.0.1

FAQ

›How do I install the Grafana MCP server in Claude Code?

Run: claude mcp add grafana -e GRAFANA_URL='<grafana-url>' -e GRAFANA_SERVICE_ACCOUNT_TOKEN='<grafana-service-account-token>' -e GRAFANA_PASSWORD='<grafana-password>' -- docker run -i --rm -e GRAFANA_URL -e GRAFANA_SERVICE_ACCOUNT_TOKEN -e GRAFANA_PASSWORD docker.io/grafana/mcp-grafana:2.0.1. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Grafana require an API key?

Yes. It expects GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN, GRAFANA_PASSWORD, of which 2 are secrets.

›Can I use Grafana as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Grafana in the official MCP registry?

Yes, as io.github.grafana/mcp-grafana.