Read-only project-level Grafana MCP: Loki logs, metrics, traces, alerts, test/prod switching
Connect Runs on your machine
claude mcp add grafana-mcp -e GRAFANA_TEST_URL=<GRAFANA_TEST_URL> -e GRAFANA_TEST_USER=<GRAFANA_TEST_USER> -e GRAFANA_TEST_PASSWORD=<GRAFANA_TEST_PASSWORD> -e GRAFANA_PROD_URL=<GRAFANA_PROD_URL> -e GRAFANA_PROD_USER=<GRAFANA_PROD_USER> -e GRAFANA_PROD_PASSWORD=<GRAFANA_PROD_PASSWORD> -e GRAFANA_ENV=<GRAFANA_ENV> -e GRAFANA_APP=<GRAFANA_APP> -- npx -y [email protected]
{
"mcpServers": {
"grafana-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"GRAFANA_TEST_URL": "<GRAFANA_TEST_URL>",
"GRAFANA_TEST_USER": "<GRAFANA_TEST_USER>",
"GRAFANA_TEST_PASSWORD": "<GRAFANA_TEST_PASSWORD>",
"GRAFANA_PROD_URL": "<GRAFANA_PROD_URL>",
"GRAFANA_PROD_USER": "<GRAFANA_PROD_USER>",
"GRAFANA_PROD_PASSWORD": "<GRAFANA_PROD_PASSWORD>",
"GRAFANA_ENV": "<GRAFANA_ENV>",
"GRAFANA_APP": "<GRAFANA_APP>"
}
}
}
}
{
"mcpServers": {
"grafana-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"GRAFANA_TEST_URL": "<GRAFANA_TEST_URL>",
"GRAFANA_TEST_USER": "<GRAFANA_TEST_USER>",
"GRAFANA_TEST_PASSWORD": "<GRAFANA_TEST_PASSWORD>",
"GRAFANA_PROD_URL": "<GRAFANA_PROD_URL>",
"GRAFANA_PROD_USER": "<GRAFANA_PROD_USER>",
"GRAFANA_PROD_PASSWORD": "<GRAFANA_PROD_PASSWORD>",
"GRAFANA_ENV": "<GRAFANA_ENV>",
"GRAFANA_APP": "<GRAFANA_APP>"
}
}
}
}
{
"servers": {
"grafana-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"GRAFANA_TEST_URL": "<GRAFANA_TEST_URL>",
"GRAFANA_TEST_USER": "<GRAFANA_TEST_USER>",
"GRAFANA_TEST_PASSWORD": "<GRAFANA_TEST_PASSWORD>",
"GRAFANA_PROD_URL": "<GRAFANA_PROD_URL>",
"GRAFANA_PROD_USER": "<GRAFANA_PROD_USER>",
"GRAFANA_PROD_PASSWORD": "<GRAFANA_PROD_PASSWORD>",
"GRAFANA_ENV": "<GRAFANA_ENV>",
"GRAFANA_APP": "<GRAFANA_APP>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
GRAFANA_TEST_URLOptional | Grafana base URL of the test environment, e.g. https://grafana.example.com |
GRAFANA_TEST_USEROptional | Grafana username for the test environment (prefer a dedicated Viewer-role account) |
GRAFANA_TEST_PASSWORDOptional, secret | Grafana password for the test environment |
GRAFANA_PROD_URLOptional | Grafana base URL of the production environment |
GRAFANA_PROD_USEROptional | Grafana username for the production environment |
GRAFANA_PROD_PASSWORDOptional, secret | Grafana password for the production environment |
GRAFANA_ENVOptional | Default environment for this project (test by default) |
GRAFANA_APPOptional | App label value used to scope Loki queries for this project |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 7 Oct 2026 |
| Last updated | 7 Oct 2026 |
| Registry name | io.github.itzhouq/grafana-mcp |
More cloud and devops servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
