
Grafana
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 toolsPublic 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_TOKENsecretService account token used to authenticate with your Grafana instance
GRAFANA_USERNAMEUsername to authenticate with your Grafana instance
GRAFANA_PASSWORDsecretPassword to authenticate with your Grafana instance
GRAFANA_ORG_IDOrganization ID for multi-org support. Can also be set via X-Grafana-Org-Id header in SSE/streamable HTTP transports.
GRAFANA_EXTRA_HEADERSJSON object of additional HTTP headers to send with all Grafana API requests
GRAFANA_FORWARD_HEADERSComma-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
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):
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