mcp server

Grafana MCP Server

Grafana Labs' MCP server for dashboards, datasources, Prometheus and Loki queries, alerting, incidents and OnCall.

grafana/mcp-grafanaofficiallistedunreviewednot running here yet

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Docker Desktop
Grafana 9.0 or later

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "grafana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN_FILE",
        "grafana/mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "<your GRAFANA_URL>"
      }
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

Tools provided

As listed by the project. Your agent asks before calling them, depending on its settings.

search_dashboardsSearch dashboards
get_dashboard_by_uidGet a dashboard by UID
query_prometheusRun a PromQL query
query_loki_logsRun a LogQL query
list_datasourcesList datasources
create_annotationCreate an annotation

README

synced Oct 13, 2026

Grafana MCP Server

Grafana Labs' MCP server for dashboards, datasources, Prometheus and Loki queries, alerting, incidents and OnCall.

Install

docker run -i --rm grafana/mcp-grafana

Configuration

Variable	Required	Description
`GRAFANA_URL`	Yes	Grafana base URL, e.g. http://localhost:3000 or a Grafana Cloud URL
`GRAFANA_SERVICE_ACCOUNT_TOKEN`	No	Service account token (recommended auth method)
`GRAFANA_SERVICE_ACCOUNT_TOKEN_FILE`	No	Path to a file holding the token; supports rotation

Tools

search_dashboards — Search dashboards
get_dashboard_by_uid — Get a dashboard by UID
query_prometheus — Run a PromQL query
query_loki_logs — Run a LogQL query
list_datasources — List datasources
create_annotation — Create an annotation

About this listing

Details were gathered from the project's public pages on 2026-10-13 and have not been reviewed by a person yet. Read the project's own documentation before giving it access to anything sensitive.

Sources:

https://github.com/grafana/mcp-grafana