NewsletterSubmit a tool

Official · by grafana

Grafana MCP server

The Grafana MCP server lets an AI assistant search and update dashboards, query datasources, and work with incidents and users in a Grafana instance.

  • Runs locally
  • Apache-2.0 licence
  • ★ 3,572 on GitHub
  • Verified against its source 19 Oct 2026
View source

What the Grafana MCP server does

The server provides access to a Grafana instance and the surrounding ecosystem. An assistant can search and retrieve dashboards, update or create dashboards, list datasources, and run queries against Prometheus, Loki, and SQL datasources. It can also list and create incidents in Grafana Incident and list teams and users, with some of these tools requiring admin access.

Tools it gives your assistant

11 tools or toolsets, as its documentation lists them.

  • list_teams Lists all teams
  • list_users_by_org
  • search_dashboards Searches dashboards by query, folder, tag, or starred
  • get_dashboard_by_uid
  • update_dashboard Updates or creates a dashboard
  • list_datasources Lists datasources
  • query_prometheus Runs a query against a Prometheus datasource
  • list_incidents Lists incidents in Grafana Incident
  • create_incident Creates an incident in Grafana Incident
  • query_loki_logs Queries and retrieves logs using LogQL
  • query_sql Executes SQL queries with macro substitution

How to install it

Run it locally

With uv (uvx)

uvx mcp-grafana

With Docker

docker pull grafana/mcp-grafana

As a binary

GOBIN="$HOME/go/bin" go install github.com/grafana/mcp-grafana/v2/cmd/mcp-grafana@latest

What you need

In the grafana documentation's own words:

  • “Create a service account in Grafana with enough permissions to use the tools you want to use, generate a service account token”
  • “Set MCP_GRAFANA_SERVER_TOKEN to require an Authorization: Bearer from clients (recommended)”
  • “Grafana version 9.0 or later is required for full functionality”
  • “Requires uv (https://docs.astral.sh/uv/getting-started/installation/)”

Commands and settings change between versions. Check the official instructions before you install.