mcp-grafana
CommunityMCP server by grafana · updated · ★ 3.6k
An MCP server giving access to Grafana dashboards, data and more. mcp-grafana is a community project by grafana, not verified by a company domain.
Install mcp-grafana
Built from the published package, never by AIclaude mcp add mcp-grafana -e GRAFANA_URL=YOUR_GRAFANA_URL -- docker run -i --rm -e GRAFANA_URL docker.io/grafana/mcp-grafana:2.1.1Run in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"mcp-grafana": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GRAFANA_URL",
"docker.io/grafana/mcp-grafana:2.1.1"
],
"env": {
"GRAFANA_URL": "YOUR_GRAFANA_URL"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"mcp-grafana": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GRAFANA_URL",
"docker.io/grafana/mcp-grafana:2.1.1"
],
"env": {
"GRAFANA_URL": "YOUR_GRAFANA_URL"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"mcp-grafana": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GRAFANA_URL",
"docker.io/grafana/mcp-grafana:2.1.1"
],
"env": {
"GRAFANA_URL": "YOUR_GRAFANA_URL"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add mcp-grafana --env GRAFANA_URL=YOUR_GRAFANA_URL -- docker run -i --rm -e GRAFANA_URL docker.io/grafana/mcp-grafana:2.1.1{
"mcpServers": {
"mcp-grafana": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GRAFANA_URL",
"docker.io/grafana/mcp-grafana:2.1.1"
],
"env": {
"GRAFANA_URL": "YOUR_GRAFANA_URL"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add mcp-grafana docker run -i --rm -e GRAFANA_URL docker.io/grafana/mcp-grafana:2.1.1Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the mcp-grafana block.
Last commit 4 days ago
Apache-2.0: permissive, fine for commercial use
Clear description, published package or server URL, 3,576 stars, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
GRAFANA_Environment variable | Required | URL to your Grafana instance |
GRAFANA_Environment variable, secret | Optional | Service account token used to authenticate with your Grafana instance |
GRAFANA_Environment variable | Optional | Username to authenticate with your Grafana instance |
GRAFANA_Environment variable, secret | Optional | Password to authenticate with your Grafana instance |
GRAFANA_Environment variable | Optional | Organization ID for multi-org support. Can also be set via X-Grafana-Org-Id header in SSE/streamable HTTP transports. |
GRAFANA_Environment variable | Optional | JSON object of additional HTTP headers to send with all Grafana API requests |
GRAFANA_Environment variable | Optional | Comma-separated list of HTTP header names to forward from the incoming request to Grafana (SSE/streamable-http only). Example: Cookie,X-Session-Id |
X-Grafana-URLHeader | Optional | URL of your Grafana Cloud instance |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Weekly newsletter
Like mcp-grafana? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to mcp-grafana
All alternatives →All Azure MCP tools to create a seamless connection between AI agents and Azure services.
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Cloudflare MCP servers
Open-source agent that observes and fixes your application. Query logs, traces, metrics, incidents.
MCP server and framework adapters for Corsair. Expose 200+ integrations to any agent framework (Mastra, LangChain, LlamaIndex, OpenAI, Vercel AI, Claude) as tools.
Analyzes deployed EVM bytecode: extracts function selectors and CBOR metadata; infers argument types, state mutability, storage layouts, and control flow.
mcp-grafana: common questions
How do I install mcp-grafana?
In Claude Code run claude mcp add mcp-grafana -e GRAFANA_URL=YOUR_GRAFANA_URL -- docker run -i --rm -e GRAFANA_URL docker.io/grafana/mcp-grafana:2.1.1. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is mcp-grafana the official server?
mcp-grafana is a community project by grafana, not verified by a company domain.
Is mcp-grafana free?
The code is published under the Apache-2.0 licence. The service it connects to may have its own pricing.
Is mcp-grafana safe to use?
It scores 93 of 100. Grades: maintenance A, licence A, quality A. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to mcp-grafana?
Similar MCP servers: Azure MCP Server, Omnara, mcp, Superlog.
Does mcp-grafana work with ChatGPT?
Yes. Add its server URL in ChatGPT as a custom connector. See MCP in ChatGPT.
