list_dashboardsLABSCO SUMMARY
It can delete, so scope the token.
Deletion tools for dashboards, datasources and folders are in the default set, and the only thing standing between an assistant and a removed dashboard is the permission on the service account token you hand it. Create a token with the narrowest role that covers what you actually want done — that decision matters more here than in a read-only integration.
What it is
A TypeScript MCP server that talks to Grafana's HTTP API over stdio. Unlike read-only Grafana integrations, this one creates and deletes: the tool set covers the whole lifecycle for the objects it manages.
What you get
- Dashboards —
list_dashboards,get_dashboard,create_dashboard,update_dashboard,delete_dashboard - Datasources —
list_datasources,get_datasource,create_datasource,delete_datasource - Alerting —
list_alert_rules,get_alert_rule, andlist_alert_instancesfor what is firing in Alertmanager - Folders —
list_folders,create_folder,delete_folder - Annotations —
list_annotationsandcreate_annotation, dashboard-scoped or global health_checkfor the instance's status- An MCP Inspector target for calling the tools interactively against a real instance before you wire it into a client
Requirements
Two environment variables, both required: GRAFANA_URL for the base URL and GRAFANA_API_KEY for a service account token or API key. Run it with bunx @daanrongen/grafana-mcp from your client config, or add it in one line with the Claude Code CLI. The transport is stdio. MIT licensed.
Setup effort
One command plus a key — bunx @daanrongen/grafana-mcp, then supply credentials
USE CASES
Building a dashboard by describing it
Create it from the conversation, then update the panels in place as you look at the result.
Finding out what is firing right now
List the alert rules and the live Alertmanager instances without opening the alerting UI.
Marking a deploy on your graphs
Write an annotation at the moment of the change so the spike afterwards has an explanation attached.
18 tools
Listed in project docs. Your client may show a different list.
get_dashboardcreate_dashboardupdate_dashboarddelete_dashboardlist_datasourcesget_datasourcecreate_datasourcedelete_datasourcelist_alert_rulesget_alert_rulelist_alert_instanceslist_folderscreate_folderdelete_folderlist_annotationscreate_annotationhealth_checkBEFORE YOU INSTALL
What to know first
Tools you get
18 tools named in the project's documentation.
Requires
- bunx on PATH
- GRAFANA_API_KEY in your environment
- GRAFANA_URL — your Grafana base URL (e.g. http://localhost:3000)
INSTALLATION
Connect your client
Server setup
bunx @daanrongen/grafana-mcpMCP Clients
Claude Desktop
{
"mcpServers": {
"grafana": {
"type": "stdio",
"command": "bunx",
"args": [
"@daanrongen/grafana-mcp"
],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_API_KEY": "<YOUR_GRAFANA_API_KEY>"
}
}
}
}Claude Code
claude mcp add grafana \
-e GRAFANA_URL=http://localhost:3000 \
-e GRAFANA_API_KEY=<YOUR_GRAFANA_API_KEY> \
-- bunx @daanrongen/grafana-mcp