Grafana MCP Server

Add to your client

Copy the config for your MCP client and paste it into its config file.

{
  "mcpServers": {
    "grafana-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "grafana/mcp-grafana",
        "-t",
        "stdio"
      ],
      "env": {
        "GRAFANA_URL": "https://your-grafana-instance.example.com",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-grafana-service-account-token>"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

• A Grafana instance, version 9.0+ recommended for full datasource functionality
• A Grafana service account token with RBAC permissions for the resources you want to access (create one under Administration > Service accounts)
• Set GRAFANA_URL and GRAFANA_SERVICE_ACCOUNT_TOKEN environment variables
• To install/build: the Go toolchain, or use the prebuilt binary, Docker image grafana/mcp-grafana, uvx, or the Helm chart

About Grafana MCP Server

Tools & capabilities (18)

When to use it

• Use it when you want to ask an assistant to run a PromQL or LogQL query and summarize the results during an investigation.
• Use it when you need to find, summarize, or edit Grafana dashboards without manually clicking through the UI.
• Use it when you're triaging an incident and want to pull OnCall schedules, current on-call users, and recent alert groups.
• Use it when you want to create or update alert rules and notification routing through natural language.
• Use it when you want Sift-powered root-cause help (error-pattern logs in Loki, slow requests via Tempo) on a live incident.
• Use it when you want a read-only assistant: run it with --disable-write so it can query but not mutate anything.

Quick setup

1. 1Create a service account in Grafana and generate a token with the RBAC scopes you need.
2. 2Set GRAFANA_URL and GRAFANA_SERVICE_ACCOUNT_TOKEN in the server's environment.
3. 3Install the server: run the binary, `uvx mcp-grafana`, the grafana/mcp-grafana Docker image, or the Helm chart.
4. 4Register it in your MCP client (stdio by default; use SSE or streamable-http for remote setups).
5. 5Optionally add --disable-write for read-only mode, then enable extra datasource/admin tool categories via flags as needed.
6. 6Restart your client and verify by asking the agent to run search_dashboards or list_datasources.

Grafana MCP Server FAQ