How to connect Grafana Cloud MCP to Claude

Connect Claude Web, Desktop and Cowork to Grafana Cloud MCP. List cpu spikes for your service, show top error logs for payment-api, and more using natural language, with authentication handled for you.

Grafana Cloud MCP logoGrafana Cloud MCP
Dcr Oauth

Grafana Cloud MCP is Grafana's observability platform for metrics, logs, traces, dashboards, alerts, and datasources. Query and explore your Grafana Cloud observability data in a unified way.

118 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Grafana Cloud account to Claude via Composio Connect, enabling it to list CPU spikes for your service, show top error logs for payment-api, create alert for high latency on checkout, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Grafana Cloud MCP with

Connecting Grafana Cloud to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Grafana Cloud account

Back in Claude, ask it to connect to Grafana Cloud or give it any Grafana Cloud-related task.

For example, ask Claude to:

  • "List CPU spikes for your service"
  • "Show top error logs for payment-api"
  • "Create alert for high latency on checkout"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Grafana Cloud account is ready to use.

What is the Grafana Cloud Claude Connector, and what's possible with it?

The Grafana Cloud MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Grafana Cloud account. It provides structured and secure access so your agent can perform Grafana Cloud operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Grafana Cloud?

The connector can show as connected, but Claude must use it in each Grafana Cloud conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Grafana Cloud again.

2. Why does Claude show an MCP server error before Grafana Cloud connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Grafana Cloud.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Grafana Cloud.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Grafana Cloud authorization link not work?

The Composio connector is one server. Your Grafana Cloud account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Grafana Cloud connection.
  • Composio creates a fresh Grafana Cloud authorization link.
  • Open that link in your browser and finish the Grafana Cloud sign-in.

4. Why do Grafana Cloud actions fail after they worked before?

The Grafana Cloud connection can expire or lose permission.

  • Ask Claude to inspect the Grafana Cloud connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Grafana Cloud account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Grafana Cloud.
  • If the action still fails with a permission error, check that the connected account has that permission in Grafana Cloud itself.

5. How do I switch to a different Grafana Cloud account?

Claude can manage the Grafana Cloud connection for you.

  • Ask Claude to disconnect or delete the current Grafana Cloud account.
  • Ask Claude to connect Grafana Cloud again.
  • Open the new Composio authorization link for Grafana Cloud.
  • Sign in with the other Grafana Cloud account in the browser.
  • After the account connects, ask Claude to retry the Grafana Cloud task.

6. Why is my Grafana Cloud connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Grafana Cloud connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click and click Clear cache.
  • If Grafana Cloud tools still do not appear, click , disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Grafana Cloud.
TOOLS

Supported Tools

Every Grafana Cloud MCP action and event your agent gets out of the box.

Add activity to incident

Add a note (userNote activity) to an existing incident's timeline using its ID.

Agento11y manage agents

Read the agent catalog of Grafana Agent Observability (the grafana-agento11y-app plugin): which agents send telemetry, what their system prompts and tools are, how their prompt versions evolved, and how each version scored.

Agento11y manage conversations

List, search, and fetch LLM conversations from Grafana Agent Observability (the grafana-agento11y-app plugin).

Agento11y manage eval collections

Manage the curated conversations of Grafana Agent Observability (the grafana-agento11y-app plugin): bookmark conversations as saved conversations and group them into collections.

Agento11y manage eval rules

Manage the evaluation rules and guards of Grafana Agent Observability (the grafana-agento11y-app plugin): the configuration that decides when evaluators run.

Agento11y manage evaluators

Manage the evaluator catalog of Grafana Agent Observability (the grafana-agento11y-app plugin): read evaluators, evaluator templates, and the judge model catalog, and create, test, or delete evaluators.

Agento11y manage experiments

Manage the offline experiments of Grafana Agent Observability (the grafana-agento11y-app plugin), their trials, and their scores.

Agento11y manage generations

Fetch a single LLM generation and its evaluation scores from Grafana Agent Observability (the grafana-agento11y-app plugin).

Agento11y manage test suites

Manage the test suites of Grafana Agent Observability (the grafana-agento11y-app plugin), their versions, and their test cases.

Alerting manage routing

Manage Grafana alerting routing configuration, including notification policies, contact points and time intervals.

Alerting manage rules

Manage Grafana alert rules with full CRUD capabilities and filtering.

Alerting manage silences

Manage Grafana alerting silences.

Analyze loki labels

Audits a Loki label strategy and optionally diagnoses query performance.

Ask assistant

Send a message to Grafana Assistant and wait for the full text reply.

Check datasources health

Check datasource health.

Create annotation

Create a new annotation on a dashboard or panel.

Create datasource

Create a datasource.

Create folder

Create a Grafana folder.

Create incident

Create a new Grafana incident.

Create investigation

Start a Grafana Assistant investigation: an agentic, multi-step root-cause analysis across the stack's metrics, logs, traces, dashboards, and alerts.

Create snapshot

Create a Grafana snapshot from a full dashboard payload.

Delete snapshot

Delete a Grafana snapshot by snapshot key.

Describe athena table

Get column names for an Athena table.

Describe clickhouse table

Get column schema for a ClickHouse table.

Describe infrastructure

Start here when users ask about their infrastructure, services, or architecture.

Describe snowflake table

Get column schema for a Snowflake table.

Generate deeplink

Generate deeplink URLs for Grafana resources.

Get alert group

Get a specific alert group from Grafana OnCall by its ID.

Get annotations

Fetch Grafana annotations using filters such as dashboard UID, time range and tags.

Get annotation tags

Returns annotation tags with optional filtering by tag name.

Get assertions

Get assertion summary for a given entity with its type, name, env, site, namespace, and a time range

Get current oncall users

Get the list of users currently on-call for a specific Grafana OnCall schedule ID.

Get dashboard by uid

Retrieves the complete dashboard, including panels, variables, and settings, for a specific dashboard identified by its UID.

Get dashboard panel queries

Retrieve panel queries from a Grafana dashboard.

Get dashboard property

Get specific parts of a dashboard using JSONPath expressions to minimize context window usage.

Get dashboard summary

Get a compact summary of a dashboard including title\, panel count\, panel types\, variables\, and other metadata without the full JSON.

Get datasource

Retrieves detailed information about a specific datasource by UID or name.

Get incident

Get a single incident by ID.

Get investigation

Get one Grafana Assistant investigation (AI-driven root-cause investigation) by ID.

Get investigation thread

Get the working thread of one Grafana Assistant investigation (AI-driven root-cause investigation) by ID: the user-visible conversation between the investigation agent and its tools.

Get oncall shift

Get detailed information for a specific Grafana OnCall shift using its ID.

Get panel image

Render a Grafana dashboard panel or full dashboard as a PNG image.

Get plugin

Check whether a Grafana plugin is installed and retrieve its details (name, version, type, enabled status).

Get query examples

Get example queries for a specific datasource type.

Get resource description

List available permissions and assignment capabilities for a Grafana resource type.

Get resource permissions

List all permissions set on a specific Grafana resource (e.

Get role assignments

List all assignments for a specific role, showing which users, teams, and service accounts have been assigned this role.

Get role details

Get detailed information about a specific Grafana role by its UID, including permissions, metadata, and configuration.

Get snapshot

Get a Grafana snapshot by key, including snapshot metadata and dashboard payload.

Grafana api request

Make an authenticated HTTP request to the Grafana API.

Install plugin

Install a Grafana plugin by its plugin ID.

List alert groups

List alert groups from Grafana OnCall with filtering options.

List all roles

List all roles in Grafana.

List athena catalogs

START HERE for Athena: List available data catalogs (e.

List athena databases

List databases in an Athena catalog.

List athena tables

List tables in an Athena database.

List clickhouse tables

START HERE for ClickHouse: List available tables (name, database, engine, row count, size).

List cloudwatch dimensions

List dimension keys for a CloudWatch metric.

List cloudwatch metrics

List metrics for a CloudWatch namespace.

List cloudwatch namespaces

START HERE for CloudWatch: List available namespaces (AWS/EC2, AWS/ECS, AWS/RDS, etc.

List datasources

List all configured datasources in Grafana.

List graphite metrics

Discover available metric paths in a Graphite datasource by browsing the metric tree.

List graphite tags

List available tag names in a Graphite datasource that uses tag-based metrics.

List incidents

List Grafana incidents.

List investigation evidence

List the evidence citation index for one Grafana Assistant investigation (AI-driven root-cause investigation) by ID.

List investigation profiles

List the agent profiles available for Grafana Assistant investigations (AI-driven root-cause investigations) on this Grafana Cloud stack.

List investigations

List Grafana Assistant investigations (AI-driven root-cause investigations) on this Grafana Cloud stack.

List loki label names

Lists all available label/field names (keys) found in logs within a specified Loki or VictoriaLogs datasource and time range.

List loki label values

Retrieves all unique values associated with a specific `labelName` within a Loki or VictoriaLogs datasource and time range.

List oncall schedules

List Grafana OnCall schedules, optionally filtering by team ID.

List oncall teams

List teams configured in Grafana OnCall.

List oncall users

List users from Grafana OnCall.

List prometheus label names

List label names in a PromQL-compatible datasource (Prometheus, Thanos, Mimir, Cloud Monitoring, etc.

List prometheus label values

Use after list_prometheus_metric_names to find label values for filtering queries.

List prometheus metric metadata

List Prometheus metric metadata.

List prometheus metric names

DISCOVERY: Call this first to find available metrics before querying.

List pyroscope label names

Lists all available label names (keys) found in profiles within a specified Pyroscope datasource, time range, and optional label matchers.

List pyroscope label values

Lists all available label values for a particular label name found in profiles within a specified Pyroscope datasource, time range, and optional label matchers.

List pyroscope profile types

Lists all available profile types available in a specified Pyroscope datasource and time range.

List snapshots

List Grafana dashboard snapshots with optional query and result limit filters.

List snowflake tables

START HERE for Snowflake: List available tables (database, schema, name, kind, row count, size) via INFORMATION_SCHEMA.

List team roles

List all roles assigned to one or more teams.

List teams

Search for Grafana teams by a query string.

List user roles

List all roles assigned to one or more users.

List users by org

List users in the Grafana organization.

Query athena

Query Amazon Athena via Grafana.

Query clickhouse

Query ClickHouse via Grafana.

Query cloudwatch

Query AWS CloudWatch metrics via Grafana.

Query elasticsearch

Executes a search query against an Elasticsearch or OpenSearch datasource and retrieves matching documents.

Query graphite

WORKFLOW: list_graphite_metrics -> query_graphite.

Query graphite density

Analyses metric data density for one or more Graphite series over a time window.

Query influxdb

Query an InfluxDB datasource via Grafana.

Query loki logs

Executes a log query against a Loki or VictoriaLogs datasource and returns matching log entries (or metric samples on Loki).

Query loki patterns

Retrieves detected log patterns from a Loki datasource for a given stream selector and time range.

Query loki stats

Retrieves index-level statistics about log streams matching a given selector within a Loki or VictoriaLogs datasource and time range.

Query prometheus

WORKFLOW: list_prometheus_metric_names -> list_prometheus_label_values -> query_prometheus.

Query prometheus histogram

Query Prometheus histogram percentiles.

Query pyroscope

Unified Pyroscope query tool for fetching profiles or metrics from Pyroscope.

Query quickwit

Executes a search query against a Quickwit datasource and retrieves matching documents.

Query snowflake

Query Snowflake via Grafana.

Run panel query

Executes one or more dashboard panel queries with optional time range and variable overrides.

Search dashboards

Search for Grafana dashboards by a query string.

Search folders

Search for Grafana folders by a query string.

Search plugin information

Search the Grafana plugin catalog by keyword to discover available plugins before installing or getting plugin details on a specific instance.

Suggest loki alloy label config

Generates an Alloy loki.

Tempo docs-config

Documentation on Tempo configuration.

Tempo docs-traceql

Documentation on TraceQL search.

Tempo get-attribute-names

Get a list of available attribute names that can be used in TraceQL queries.

Tempo get-attribute-values

Get a list of values for a fully scoped attribute name.

Tempo get-trace

Retrieve a specific trace by ID

Tempo traceql-metrics-instant

Retrieve a single metric value given a TraceQL metrics query.

Tempo traceql-metrics-range

Retrieve a metric series given a TraceQL metrics query.

Tempo traceql-search

Search for traces using TraceQL queries

Update alert group

Update the state of a Grafana OnCall alert group: acknowledge, unacknowledge, resolve, or unresolve it by ID.

Update annotation

Updates the provided properties of an annotation by ID.

Update dashboard

Create or update a dashboard.

Update datasource

Update non-secret datasource fields by UID.

Update incident

Update an existing Grafana incident by ID.

FAQ

Frequently asked questions

With a standalone Grafana Cloud MCP server, the agents and LLMs can only access a fixed set of Grafana Cloud tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Grafana Cloud and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Grafana Cloud tools.

Yes, absolutely. You can configure which Grafana Cloud scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Grafana Cloud data and credentials are handled as safely as possible.

Start with Grafana Cloud MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Grafana Cloud MCP tool your agent needs.Free to start.

Start building