Grafana MCP Server

A [Model Context Protocol][mcp] (MCP) server for Grafana. This provides access to your Grafana instance and the surrounding ecosystem. Its 40 documented tools cover loki, dashboard, prometheus, label.

People who work with loki, dashboard and prometheus and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Go.

VERIFIED ACTIVE

LAST COMMIT 2026-09-17 · ★ 3,467 · #15 OF 120 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-09-18

Apache-2.0 · Go servers · how we verify → /methodology

01 · Install Grafana

before you install - you'll need

Set GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN before connecting.

Claude Code

claude mcp add grafana-mcp-grafana --transport http https://mcp.grafana.com/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "grafana-mcp-grafana": {
      "url": "https://mcp.grafana.com/mcp"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://mcp.grafana.com/mcp

transport: streamable-http

endpoint alive - authentication required · probed 2026-09-17

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as container (OCI image) - can be sandboxed away from your filesystem · remote - your agent's requests go to mcp.grafana.com

endpoint auth requires authentication - rejected our unauthenticated MCP initialize

license Apache-2.0 - declared in the repository

registry namespace io.github.grafana is GitHub-verified and matches the repo owner

03 · What Grafana can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all teams, list all users in an organization, list all Grafana roles, and get details for a Grafana role.

Capability map

Tools grouped from the project's README - what Grafana lets an agent do.

read & search

9 tools - e.g. List all teams; List all users in an organization; List all Grafana roles

list_teams · list_users_by_org · list_all_roles · list_team_roles · search_dashboards · list_datasources…

Loki

7 tools - e.g. Query and retrieve logs using LogQL (either log or metric queries); List all available label names in logs; List values for a specific log label

query_loki_logs · list_loki_label_names · list_loki_label_values · query_loki_stats · query_loki_patterns · analyze_loki_labels…

Dashboard

6 tools - e.g. Get a dashboard by uid, optionally a saved version; List saved versions of a dashboard (version, author, time, message); Update or create a new dashboard

get_dashboard_by_uid · list_dashboard_versions · update_dashboard · get_dashboard_panel_queries · get_dashboard_property · get_dashboard_summary

Prometheus

6 tools - e.g. Execute a query against a Prometheus datasource; List metric metadata; List available metric names

query_prometheus · list_prometheus_metric_metadata · list_prometheus_metric_names · list_prometheus_label_names · list_prometheus_label_values · query_prometheus_histogram

Incident

5 tools - e.g. Create an incident in Grafana Incident, optionally setting custom fields; Add an activity item to an incident in Grafana Incident; Update an incident in Grafana Incident (status, severity, title, or…

create_incident · add_activity_to_incident · update_incident · get_incident · list_incident_custom_fields

Role

2 tools - e.g. Get details for a Grafana role; List assignments for a role

get_role_details · get_role_assignments

User

2 tools - e.g. List roles for users; Current identity, capabilities, and accessible organizations

list_user_roles · user_info

Resource

2 tools - e.g. List permissions for a resource; Describe a Grafana resource type

get_resource_permissions · get_resource_description

Latest releases

v1.5.1 · 2026-09-17

Fixed · shorten_url no longer doubles the Grafana sub-path prefix when generating short links on instances served under a sub-path (#1205) · get_annotation_tags now accepts limit as a number instead of a string, fixing…

v1.5.0 · 2026-09-17

Added · Anonymous usage statistics reporting with per-process event unit, configurable via --usage-stats / GRAFANA_USAGE_STATS (modes: enabled, disabled, log; default disabled). Supports DO_NOT_TRACK=1, reports tool…

v1.4.2 · 2026-09-14

Added · Optional version parameter on get_dashboard_by_uid to retrieve a specific saved version of a dashboard. New list_dashboard_versions tool returns version metadata (version number, author, timestamp, message)…

04 · Who maintains Grafana

mcp-grafana is maintained by grafana. It's the only MCP server we track from this author; the repo dates to Dec 2024.

05 · Facts

category
DevOps & monitoring - ranked #15 of 120 actively-maintained DevOps & monitoring servers as of 2026-09-18.
release cadence
10+ releases in the last 90 days (latest 2026-09-17)
registry
io.github.grafana/mcp-grafana (active, first published 2025-10-15 · 30 versions)
packages
oci:docker.io/grafana/mcp-grafana:1.5.1

06 · Grafana FAQ

Is Grafana still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-17 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Grafana do?

With this server connected, an agent can list all teams, list all users in an organization, list all Grafana roles, and get details for a Grafana role.

How do I install Grafana?

Run `claude mcp add grafana-mcp-grafana --transport http https://mcp.grafana.com/mcp`. The README documents 2 environment variables (GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN) to set first. Set GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN before connecting. You can also paste the ready-made client config above.

Does Grafana require authentication?

Yes - when we probed the endpoint on 2026-09-17, it rejected an unauthenticated MCP initialize; you'll need credentials to connect.

07 · Alternatives to Grafana