grafana avatar

Grafana

grafana/mcp-grafanaOfficial

Connects to Grafana instances (self-hosted or Cloud) via service account tokens and exposes dashboards, datasources, and query execution. You get CRUD operations on dashboards with JSONPath support for targeted updates, plus native querying against Prometheus, Loki, ClickHouse, CloudWatch, Athena, Snowflake, InfluxDB, and Graphite datasources. Most query tools are opt-in via flags to keep the surface area manageable. The run panel query feature lets you execute dashboard panel queries with custom time ranges and variable overrides. Useful when you want to pull observability data or modify dashboards programmatically without switching contexts to the Grafana UI. Requires Grafana 9.0 or later for full API support.

GitHub stars
3.7K
tools
18
auth
Secret needed
transport
STDIO, HTTP
env vars
7
last updated
Nov 10, 2026

Tools

18 tools

Public tool metadata for what this MCP can expose to an agent.

list_teamsList all teams

List all teams

No parameter schema in public metadata yet.

list_users_by_orgList users in an organization, with search and pagination

List users in an organization, with search and pagination

No parameter schema in public metadata yet.

list_all_rolesList all Grafana roles

List all Grafana roles

No parameter schema in public metadata yet.

get_role_detailsGet details for a Grafana role

Get details for a Grafana role

No parameter schema in public metadata yet.

get_role_assignmentsList assignments for a role

List assignments for a role

No parameter schema in public metadata yet.

list_user_rolesList roles for users

List roles for users

No parameter schema in public metadata yet.

list_team_rolesList roles for teams

List roles for teams

No parameter schema in public metadata yet.

get_resource_permissionsList permissions for a resource

List permissions for a resource

No parameter schema in public metadata yet.

get_resource_descriptionDescribe a Grafana resource type

Describe a Grafana resource type

No parameter schema in public metadata yet.

user_infoCurrent identity, capabilities, and accessible organizations

Current identity, capabilities, and accessible organizations

No parameter schema in public metadata yet.

search_dashboardsSearch for dashboards by query, folder UID, folder path, tag, or starred

Search for dashboards by query, folder UID, folder path, tag, or starred

No parameter schema in public metadata yet.

search_foldersSearch for folders by title

Search for folders by title

No parameter schema in public metadata yet.

get_dashboard_by_uidGet a dashboard by uid, optionally a saved version

Get a dashboard by uid, optionally a saved version

No parameter schema in public metadata yet.

list_dashboard_versionsList saved versions of a dashboard (version, author, time, message)

List saved versions of a dashboard (version, author, time, message)

No parameter schema in public metadata yet.

update_dashboardUpdate or create a new dashboard

Update or create a new dashboard

No parameter schema in public metadata yet.

get_dashboard_panel_queriesGet panel title, queries, datasource UID and type from a dashboard

Get panel title, queries, datasource UID and type from a dashboard

No parameter schema in public metadata yet.

run_panel_queryExecute one or more dashboard panel queries

Execute one or more dashboard panel queries

No parameter schema in public metadata yet.

get_dashboard_propertyExtract specific parts of a dashboard using JSONPath expressions

Extract specific parts of a dashboard using JSONPath expressions

No parameter schema in public metadata yet.

Sponsors

Configuration

GRAFANA_URL*

URL to your Grafana instance

GRAFANA_SERVICE_ACCOUNT_TOKENsecret

Service account token used to authenticate with your Grafana instance

GRAFANA_USERNAME

Username to authenticate with your Grafana instance

GRAFANA_PASSWORDsecret

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

Readme

Grafana MCP server

Unit Tests Integration Tests E2E Tests Go Reference MCP Catalog

A Model Context Protocol (MCP) server for Grafana.

This provides access to your Grafana instance and the surrounding ecosystem.

Quick Start

Requires uv. Add the following to your MCP client configuration (e.g. Claude Desktop, Cursor):


View the full README on GitHub

Details

Repository
github.com/grafana/mcp-grafana
Website
grafana.com/docs/grafana/latest/developer-resources/mcp
Categories
Monitoring & Observability, Data & Analytics
Package
docker.io/grafana/mcp-grafana:2.3.0
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

Related Monitoring & Observability MCP servers

View all
1tjhop avatarPrometheus MCP Servertjhop/prometheus-mcp-serverAn API-complete MCP server to manage Prometheus-compatible backends.48stars
2agent-analytics avatarAgent Analyticsagent-analytics/agent-analytics-mcpAnalytics your AI agent can actually use. Track, experiment, and optimize via MCP.0stars
3dailyaiagents-cpu avatarGitignore Drift Monitordailyaiagents-cpu/dailyai-osWatcher — count uncommitted files in repo, surface dominant drift class. YELLOW >100, RED >250.0stars
4mdfifty50-boop avatarTrace Forgemdfifty50-boop/trace-forge-mcpStructured execution trace and span logging for AI agents0stars
5srotzin avatarHive Sla Monitorsrotzin/hive-mcp-sla-monitorService level agreement monitoring for the Hive agent fleet0stars
6vola-trebla avatarNdjson Local Log Triage Mcpvola-trebla/ndjson-local-log-triage-mcpStreams NDJSON log triage: query patterns, detect anomalies, summarize timelines without full load.0stars