# Install mcp-grafana with Homebrew, Nix

MCP server for Grafana. Version 0.17.1 via Homebrew; verified 2026-07-07.

## Install

```sh
sudo av install brew:mcp-grafana
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mcp-grafana
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#mcp-grafana
```

  Evidence: nixpkgs package indexes: pkgs/by-name/mc/mcp-grafana/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:mcp-grafana
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mcp-grafana>
- **Version:** 0.17.1
- **Source summary:** MCP server for Grafana
- **Homepage:** <https://github.com/grafana/mcp-grafana>
- **Repository:** <https://github.com/grafana/mcp-grafana>
- **Upstream docs:** <https://github.com/grafana/mcp-grafana#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/grafana/mcp-grafana/archive/refs/tags/v0.17.1.tar.gz>
- **Last updated:** 2026-07-07T09:58:57Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- mcp-grafana (cli)
- mcp-grafana (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.17.1
- Package-manager updated: 2026-07-07
- Local data: ok
- Upstream repository: https://github.com/grafana/mcp-grafana
- Upstream latest detected: v0.17.1 (current)
## Project history and usage

mcp-grafana is Grafana Labs' Model Context Protocol server for Grafana. It exposes Grafana instances and related observability workflows to MCP-compatible clients through tools for dashboards, datasources, incidents, alerting, on-call data, snapshots, and more.

### Project history

The official GitHub repository was created in December 2024 and is maintained under the grafana organization with Apache-2.0 licensing. The project has first-party Grafana documentation as well as a GitHub README, Go package documentation, Docker image usage, binary releases, uvx startup, and a Helm chart route.

The release stream grew quickly through 2025 and 2026, with GitHub releases such as v0.12.0 in April 2026 and v0.17.0 in June 2026. The README shows the server expanding beyond basic dashboard access into richer Grafana ecosystem coverage.

### Adoption history

By July 2026, official GitHub metadata showed thousands of stars and hundreds of forks, while the supplied package-manager facts list Homebrew and Nix packaging. Its placement under the Grafana organization gives it first-party visibility that most MCP servers do not have.

The project reflects a broader shift in observability tooling: instead of only exposing dashboards through browser UI and APIs, Grafana can be queried and modified through AI clients using a local or hosted MCP server.

### How it is used

The README quick start configures an MCP client to run mcp-grafana with GRAFANA_URL and GRAFANA_SERVICE_ACCOUNT_TOKEN. It also documents token-file support through GRAFANA_SERVICE_ACCOUNT_TOKEN_FILE, username/password alternatives, organization selection, custom headers, Docker, binary, Helm, and transport options.

Documented tools cover dashboard retrieval and patching, datasource queries, Prometheus/Loki/CloudWatch/Athena/ClickHouse/Snowflake-related workflows, incidents, Sift investigations, alerting, OnCall, teams, roles, annotations, snapshots, rendering, and provisioning repository validation.

### Why package nerds care

mcp-grafana is significant because it is a first-party MCP server from a major observability vendor, not just a community adapter. For package managers, that means a fast-moving operational tool with real deployment modes: uvx for local clients, Docker for containers, binaries for PATH installs, and Helm for clusters.

It also shows how MCP packages can grow beyond simple CRUD wrappers into opinionated context-management tools, such as compact dashboard summaries and JSONPath dashboard property extraction to control model context size.

### Timeline

- 2024-12: GitHub repository created under grafana.
- 2026-04: v0.12.0 release published.
- 2026-06: v0.17.0 release published.
- 2026-07: Repository metadata showed active maintenance and broad GitHub adoption.

### Related projects

- Related projects include Grafana, Grafana Cloud, Grafana OnCall, Grafana Incident, the Grafana Helm charts, and other observability-focused MCP servers.

### Sources

- <https://github.com/grafana/mcp-grafana>
- <https://github.com/grafana/mcp-grafana#readme>
- <https://github.com/grafana/mcp-grafana/releases>
- <https://grafana.com/docs/grafana/latest/developer-resources/mcp>
- <https://pkg.go.dev/github.com/grafana/mcp-grafana>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for mcp-grafana. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mcp-grafana
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - mcp-grafana: normalized package name match | nixpkgs package indexes: pkgs/by-name/mc/mcp-grafana/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [grizzly](https://www.automicvault.com/pkg/brew/grizzly/) - Shares av.db curated category or tags: cli, cloud-infrastructure, dashboards, grafana, observability.
- [logcli](https://www.automicvault.com/pkg/brew/logcli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, grafana, observability.
- [mimirtool](https://www.automicvault.com/pkg/brew/mimirtool/) - Shares av.db curated category or tags: cli, cloud-infrastructure, grafana, observability.
- [newrelic-infra-agent](https://www.automicvault.com/pkg/brew/newrelic-infra-agent/) - Shares av.db curated category or tags: cli, cloud-infrastructure, monitoring, observability.
- [mcp-server-kubernetes](https://www.automicvault.com/pkg/brew/mcp-server-kubernetes/) - Shares av.db curated category or tags: cli, cloud-infrastructure, mcp.
- [sloth-cli](https://www.automicvault.com/pkg/brew/sloth-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, observability.
- [swctl](https://www.automicvault.com/pkg/brew/swctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, observability.
- [prometheus](https://www.automicvault.com/pkg/brew/prometheus/) - Shares av.db curated category or tags: cli, cloud-infrastructure, monitoring, observability.

## Combined YAML source

View the package source record on GitHub. [combined/mcp-grafana.yml](https://github.com/automic-vault/db/blob/main/combined/mcp-grafana.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
