Grafana MCP server

This documentation helps you install the Grafana MCP server, connect MCP-compatible clients, and configure authentication, transports, and tools.

The Grafana MCP server is a Model Context Protocol (MCP) server that gives AI assistants and LLM clients access to your Grafana instance. You can query metrics and logs, search and manage dashboards, manage alert rules, work with Grafana Incident and Sift, and generate deeplinks to Grafana resources.

Overview

Use the Grafana MCP server to let your preferred MCP-compatible client (for example, Claude Desktop, Cursor, or VS Code with Copilot) talk to Grafana. The server exposes tools for dashboards, datasources (Prometheus, Loki, and others), alerting, incidents, OnCall, and more. You configure which tools are enabled and how the server connects to Grafana (authentication and transport).

Quick start

This quick start requires uv. Add this to your MCP client configuration (for example Claude Desktop or Cursor):

{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": ["mcp-grafana"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      }
    }
  }
}

For Grafana Cloud, set GRAFANA_URL to your instance URL (for example https://myinstance.grafana.net). Refer to Clients and Set up for next steps.

Grafana 9.0 or later is required for full functionality. Some features, particularly datasource-related operations, may not work correctly with earlier versions due to missing API endpoints.

Explore the docs

Clients – Cursor, Claude Desktop, VS Code, and more.
Set up – uvx, Docker, binary, Helm, and client configuration examples.
Configure – Authentication, command-line flags, transports, TLS, and tools.
Introduction – MCP concepts and RBAC overview.
Reference – MCP tools reference (tools, permissions, scopes, and RBAC guidance).
Guides – Query metrics and logs, dashboards, alerts, deeplinks, incidents.
Troubleshooting – Common issues including Grafana version compatibility.
Developer – Go SDK, observability, build and test.