Skip to content

grafana/grafana-cloud-mcp

v0.3.1Apache-2.0

For Grafana Cloud: a hosted MCP server with OAuth sign-in for dashboards, metrics, logs, traces, alerts, and incidents. Nothing to install.

GitHubOpen Website

Grafana Cloud

Plugin that connects AI agents to the hosted Grafana Cloud MCP server for AI-assisted observability workflows.

The Cloud MCP server is fully hosted and uses OAuth 2.1 authorization — no local installation or service account tokens required.

Using claude.ai, Claude Desktop, mobile, or Cowork? Add the Grafana Cloud connector (https://mcp.grafana.com/mcp) under Customize → Connectors (on Team or Enterprise, an Owner adds it under Organization settings → Connectors). This plugin uses the same server and sign-in, and adds the grafana-cloud-mcp-tools skill — install it as well as the connector where plugins are supported, and you'll see one set of tools, not two.

Prerequisites

  1. A Grafana Cloud account. Self-hosted users should use the grafana-mcp plugin instead.
  2. An administrator must accept the Grafana Assistant terms and conditions.
  3. You need the Assistant Cloud MCP User role or the grafana-assistant-app.cloud-mcp:access permission. Users with Editor role or higher have this by default.

Setup

No local installation or environment variables required. When your AI agent first connects, you'll be prompted to enter your Grafana Cloud URL and authorize the connection in your browser. Your OAuth token is valid for 1 hour and refreshes automatically for 30 days.

Available tools

The Cloud MCP server provides dozens of tools across these categories:

CategoryExamples
Dashboardssearch, get summary, get property, update
Datasourceslist, get by UID or name
PrometheusPromQL queries, metric metadata, label names/values
LokiLogQL log/metric queries, label metadata, patterns
TempoTraceQL queries, attribute discovery (proxied from datasource)
Pyroscopeprofile queries, label names/values, profile types
SQLlist databases and tables, describe tables, SQL queries
CloudWatchnamespaces, metrics, dimensions, queries
ElasticsearchLucene and Query DSL searches
Alertingalert rules, notification routing, contact points, silences
Incidentssearch, create, add activity
OnCallschedules, shifts, on-call users, alert groups
Annotationsget, create, update, list tags
Navigationgenerate deeplinks to dashboards, panels, Explore
Renderingexport dashboard panels as PNG images
Assistantask Grafana Assistant, run investigations and read reports

See the Grafana Cloud MCP documentation for the full tool reference.

Privacy and support