PlugWiki
mcp-grafana logo

Grafana MCP, Grafana Labs' official MCP server

Official · by Grafana LabsRemoteLocal
Gethttps://mcp.grafana.com/mcpgrafana/mcp-grafanaDocs

Lets your AI assistant search Grafana dashboards, query your metrics and logs, and manage alerts and incidents.

This is Grafana Labs' own server. It lets Claude, Cursor and other assistants search dashboards, query Prometheus and Loki, and manage alerts and incidents. You can run it yourself for free with a service account token, on Grafana Cloud or self-hosted Grafana 9.0 and later. Grafana Cloud also runs a hosted version you sign in to, but it needs Grafana Assistant and bills each user as an Assistant user.

Good for

  • On-call engineers who want Claude to dig through metrics, logs and traces when something breaks
  • Developers asking why an app is slow, using real CPU, trace and query data
  • Teams that want to find dashboards and alert rules by describing them in plain words
  • Grafana Cloud teams already paying for Grafana Assistant who prefer a no-install connection

Works in

8 supported · 6 should work

Tap an app to see how to set it up and any known problems.

Install mcp-grafana

Claude Code

  1. 1

    Copy this prompt.

    Add the mcp-grafana server to Claude Code. Run this command:
    
    claude mcp add grafana -e GRAFANA_URL=<GRAFANA_URL> -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<GRAFANA_SERVICE_ACCOUNT_TOKEN> -- uvx mcp-grafana
    
    Ask me for GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN and only put the values in that config, nowhere else.
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires uv (Python), Grafana 9.0 or later.

Read-only mode: Add the --disable-write flag to the args (after mcp-grafana) to run in read-only mode. It removes the write tools, including the raw SQL and InfluxDB query tools. For Docker, add it after -t stdio.

Needs Grafana 9.0 or later. Create a service account in Grafana, generate a token, and put it in the env values. Grafana's own tip: if you do not want to set fine-grained permissions, the built-in Editor role covers most tools, but it can write. For Grafana Cloud, use your instance address as the URL. The Docker image defaults to SSE, so the stdio method passes -t stdio and needs -i. GRAFANA_API_KEY is deprecated; use the service account token.

From the project README. Source.

Tools

  • Finds dashboards by name, folder, tag or star

    Finds dashboards by name, folder, tag or star.

    Try: “Find my dashboards tagged production”

    Read · search_dashboards

  • Gives a compact summary of a dashboard

    Gives a compact summary of a dashboard.

    Try: “Summarize the API latency dashboard”

    Read · get_dashboard_summary

  • Opens a full dashboard, or an older saved version

    Opens a full dashboard, or an older saved version.

    Try: “Open the dashboard with uid abc123”

    Read · get_dashboard_by_uid

  • Lists the queries behind each dashboard panel

    Lists the queries behind each dashboard panel.

    Try: “What queries power the panels on my latency dashboard?”

    Read · get_dashboard_panel_queries

  • Pulls one part out of a dashboard

    Pulls one part out of a dashboard.

    Try: “Get the template variables from this dashboard”

    Read · get_dashboard_property

  • Shows the saved versions of a dashboard

    Shows the saved versions of a dashboard.

    Try: “Show the version history of my latency dashboard”

    Read · list_dashboard_versions

  • Finds folders by title

    Finds folders by title.

    Try: “Find the folder called Platform”

    Read · search_folders

  • Runs a Prometheus query

    Runs a Prometheus query.

    Try: “What is the request rate for the checkout service over the last hour?”

    Read · query_prometheus

  • Searches your logs with a Loki query

    Searches your logs with a Loki query.

    Try: “Show error logs from the checkout service in the last 15 minutes”

    Read · query_loki_logs

  • Searches traces with TraceQL

    Searches traces with TraceQL.

    Try: “Find traces slower than 2 seconds in the payments service”

    Read · search_tempo_traces

  • Fetches one trace by ID

    Fetches one trace by ID.

    Try: “Show me trace 4bf92f3577b34da6”

    Read · get_tempo_trace

  • Lists your connected data sources

    Lists your connected data sources.

    Try: “What data sources do I have in Grafana?”

    Read · list_datasources

Read from the source code

Pros and cons

Good

  • Made and maintained by Grafana Labs.
  • Free and open source under Apache-2.0 for Grafana Cloud or your own Grafana.
  • Covers dashboards, Prometheus and Loki queries, alerting, incidents and OnCall in one server.
  • Read-only mode with one flag, plus a Viewer service account for tighter access.
  • Load only the tool groups you need to save context.
  • Hosted Grafana Cloud option needs no install and signs you in with your own account.

Watch out

  • The full tool set uses about 16K tokens of context.
  • Write tools are on by default.
  • Raw SQL tools can change data unless read-only mode is on.
  • Needs Grafana 9.0 or later.
  • The hosted server is Grafana Cloud only, needs Grafana Assistant and bills each user.
  • Cloud access policy tokens do not work, only service account tokens.

Permissions

medium risk · 6 things to watch

Medium risk

The assistant can change dashboards and alert rules, and run SQL that edits or drops data, if the token you give it allows that. Start in read-only mode and use a Viewer service account.

What it can do

Watch out for

  • Write tools are on by default

    Unless you turn on read-only mode, the assistant can create and update dashboards, alert rules, incidents and annotations, and delete alert rules. Start with read-only and add write access later. github.com

  • SQL tools run any statement the database allows

    A DROP TABLE or DELETE runs if the datasource login permits it. Read-only mode removes these tools; on the hosted server, clear Query as well as Write. github.com

  • Network modes need a caller token

    The Docker image listens on all network addresses in SSE or streamable-http mode. Set a server token so callers must send it. github.com

  • The Editor role gives more access than needed

    Grafana's docs offer Editor as the easy choice for the service account. Use Viewer, or the per-tool permissions in the README, unless you need write tools. github.com

  • Usage stats go to Grafana Labs by default

    Tool names, failure counts and flag names are sent; queries and credentials are not. Set DO_NOT_TRACK=1 to stop it. github.com

  • The hosted server acts as you

    It uses your own Grafana permissions. You can revoke a connection under Settings, Connectors, MCP clients. grafana.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyStart the server with --disable-write: write tools and raw SQL/InfluxDB query tools are removed, PromQL/LogQL queries stay. Pair it with a Viewer-level service account. On the hosted Cloud server, clear Write and Query access on the consent page.
Talks toYour Grafana instance. Grafana Labs (anonymous usage stats, can be turned off)

Alternatives

Use this server if your metrics and logs are in Grafana. Pick the Prometheus or VictoriaMetrics server if you query those directly, SigNoz if you run it instead of Grafana, and mcp-k6 for load tests.

ServerOfficialRunsCan change thingsGitHub stars
For Grafana
GrafanaThis pageOfficialHostedLocalYes3.6K
mcp-k6Official––56
Other tools for the same job
Prometheus MCP ServerCommunityLocal–521
mcp-victoriametricsCommunityLocal–240
SigNoz MCP ServerFor SigNozOfficialHostedLocal–130

What people say

People like how much debugging time it saves and dislike how much context its full tool set uses.

What people like

  • Engineers say it saves days of debugging when paired with read-only kubectl in Claude Code.
  • An agent can pull metrics, traces and CPU profiles itself and work out why an app is slow.
  • It works against a small self-hosted Grafana as well as Grafana Cloud.

Common complaints

  • The default tool set is about 16K tokens, close to 10% of Claude's context.
  • The Claude Desktop directory copy trails releases, so some users install extra tools to get a working version.
  • Only service account tokens or basic sign-in work, not Grafana Cloud access policy tokens.

In their words

Questions

Is the Grafana MCP server free?

The server you run yourself is free and open source. The hosted server at mcp.grafana.com is billed as part of Grafana Assistant, and each user who connects counts as an active Assistant user. Read-only use does not use Assistant tokens.

Should I use the hosted server or run it myself?

Run it yourself if you use self-hosted Grafana, want it free, or do not have Grafana Assistant. Use the hosted server if you are on Grafana Cloud, have Assistant enabled, and want sign-in with no token or install.

What is the Grafana MCP server URL?

The hosted Grafana Cloud address is https://mcp.grafana.com/mcp. For several Cloud stacks, add one entry per stack ending in /mcp/<your-stack>.grafana.net. The self-run version has no fixed address.

Which Grafana versions does it need?

Grafana 9.0 or later. On older versions the datasource tools fail with an "id is invalid" error, and the maintainers do not plan to support 8.5. A few tools need more, such as the Google Cloud Logging tools, which need Grafana 11.2.

How do I make it read-only?

Start the server with the --disable-write option. That removes create, update and delete tools and the raw SQL tools, while metric and log queries keep working. On the hosted server, clear Write and Query on the sign-in page; clearing only Write still allows raw SQL.

What permissions does the service account need?

Enough for the tools you use; the README lists the exact permissions per tool. Use a Viewer account for read-only work. The built-in Editor role is simpler but gives broad write access.

How much of my context window does it use?

The full tool set takes about 16K tokens, close to 10% of Claude's context. You can load only the tool groups you need to cut that down.

Can it delete things?

Yes, unless read-only mode is on. It can delete alert rules, and its SQL tools run any statement your datasource login allows.

Does it send data to Grafana Labs?

By default it sends anonymous usage stats: which tools ran, how many failed and flag names. Queries, log lines and credentials are not sent, and you can turn it off.

Why does Docker connect but my client sees no server?

The Docker image starts in a network mode by default. For Claude Desktop, Cursor and similar apps, add the stdio options to the docker run arguments, as the README shows.

Examples

  • Find out why an app is slow from metrics, traces and CPU profiles

    Why is the checkout service slow since yesterday? Check metrics, traces and CPU profiles.

  • Explain a resource trend on a self-hosted Grafana

    Why has CPU been increasing this week?

    Source
  • Debug an infrastructure problem from Claude Code alongside read-only kubectl

    Source
  • Check observability data while QA-testing a web server against a local Grafana

    Source

Information

updated Nov 2, 2026

Publisher
Grafana Labs (official)
Package
grafana/mcp-grafana
Registry
Docker
Endpoint
https://mcp.grafana.com/mcp
Transport
stdio, SSE, Streamable HTTP
Version
v2.1.1
License
Apache-2.0
Last commit
Oct 31, 2026
Open issues
56
Listed in
Official MCP registry, Docker MCP Catalog

Grafana MCP server docsGitHubDockerOfficial MCP RegistrySet up by clientChangelogIssuesGrafana Cloud hosted MCP server

Other Grafana MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 18
  1. mcp-grafana README · github.com
  2. grafana.com · grafana.com
  3. grafana.com · grafana.com
  4. github.com · github.com
  5. github.com · github.com
  6. Grafana MCP client setup guides · grafana.com
  7. github.com · github.com
  8. github.com · github.com
  9. github.com · github.com
  10. github.com · github.com
  11. github.com · github.com
  12. github.com · github.com
  13. news.ycombinator.com · news.ycombinator.com
  14. news.ycombinator.com · news.ycombinator.com
  15. github.com · github.com
  16. news.ycombinator.com · news.ycombinator.com
  17. news.ycombinator.com · news.ycombinator.com
  18. SigNoz MCP Server · signoz.io

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.