# Install mcp-toolbox with Homebrew, dnf, Nix, pacman, winget, zypper

MCP server for databases. Version 1.6.0 via Homebrew; verified 2026-07-04.

## Install

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

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mcp-toolbox
```

  Evidence: local Homebrew formula metadata

### Linux

- dnf (92%):

```sh
sudo dnf install toolbox
```

  Evidence: Fedora Rawhide package metadata: toolbox from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#toolbox
```

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

- pacman (92%):

```sh
sudo pacman -S toolbox
```

  Evidence: Arch Linux sync databases: toolbox from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install toolbox
```

  Evidence: openSUSE Tumbleweed package metadata: toolbox from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- winget (92%):

```sh
winget install --id Japplis.Toolbox -e
```

  Evidence: Windows Package Manager source index: Japplis.Toolbox from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:mcp-toolbox
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mcp-toolbox>
- **Version:** 1.6.0
- **Source summary:** MCP server for databases
- **Homepage:** <https://github.com/googleapis/mcp-toolbox>
- **Repository:** <https://github.com/googleapis/mcp-toolbox>
- **Upstream docs:** <https://github.com/googleapis/genai-toolbox#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/googleapis/mcp-toolbox/archive/refs/tags/v1.6.0.tar.gz>
- **Last updated:** 2026-07-04T16:53:44+09:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- toolbox (cli)
- toolbox (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: 1.6.0
- Package-manager updated: 2026-07-04
- Local data: ok
- Upstream repository: https://github.com/googleapis/mcp-toolbox
- Upstream latest detected: v1.6.0 (current)
## Project history and usage

MCP Toolbox for Databases is Google's open-source Model Context Protocol server for connecting AI agents, IDEs, and applications to databases. It occupies the database-access side of the MCP ecosystem: instead of each client inventing its own SQL bridge, Toolbox offers prebuilt database tools and a framework for defining safer custom tools.

### Project history

The project began publicly on GitHub in June 2024 under the Google APIs organization as Gen AI Toolbox for Databases. Its own README notes that the initial development predated MCP and that the repository was later renamed from `genai-toolbox` to `mcp-toolbox` to align with MCP compatibility.

By 2026 the project documentation had moved to the `mcp-toolbox.dev` documentation site, with dedicated sections for configuration, sources, tools, toolsets, prompts, SDKs, deployment, and database-specific integrations. The package is distributed as a command-line server binary, Docker/container artifact, and SDK-adjacent tooling, with the Homebrew formula exposing the `toolbox` executable.

### Adoption history

The official README positions Toolbox for use with MCP-compatible IDEs and clients including Gemini CLI, Google Antigravity, Claude Code, Codex, and other MCP clients. It also documents integration paths for ADK, LangChain, LlamaIndex, and custom agents, which made it relevant beyond a single chat client.

GitHub repository metadata showed substantial public adoption by July 2026, with roughly 15.8k stars and 1.6k forks. The project's releases began with v0.0.1 in October 2024 and reached v1.6.0 on July 1, 2026, signaling rapid development across the first two years of the MCP wave.

### How it is used

Typical package-manager usage is to install the `toolbox` binary and either run prebuilt database tools with flags such as `--prebuilt=postgres` or run a custom configuration with `--config tools.yaml`. The README documents a `tools.yaml` model containing sources, tools, toolsets, and prompts, while the docs expand that into database-specific source and tool reference pages.

The package is especially aimed at database-aware assistant workflows: listing schemas, executing SQL, wrapping predefined production queries, adding semantic search or NL2SQL features, and using authentication, connection pooling, and observability rather than handing every MCP client a raw database script.

### Why package nerds care

For package-history purposes, MCP Toolbox is a representative example of a large vendor-backed MCP server becoming a packaged CLI. It matters because it turns database access for agent tools into something installable, versioned, and documented across clients, rather than a pile of per-client JSON snippets and local scripts.

It is also notable for its rename: package records may still carry `genai-toolbox` URLs, while the official repository and documentation now use `mcp-toolbox`. That makes it a useful case where package metadata, repository redirects, and documentation URLs can diverge during a young ecosystem's naming cleanup.

### Timeline

- 2024-06: Public GitHub repository created as the project that became MCP Toolbox for Databases.
- 2024-10: v0.0.1 release published.
- 2025: Project renamed from Gen AI Toolbox for Databases / genai-toolbox to MCP Toolbox / mcp-toolbox to match MCP compatibility.
- 2026-07: v1.6.0 release published; official docs list broad database integrations and MCP client connection guides.

### Related projects

- Related projects include MCP clients such as Claude Code, Codex, Gemini CLI, and IDE integrations, plus agent frameworks such as ADK, LangChain, and LlamaIndex. Within the same package set it is adjacent to MCPHost, MCPM, and mcptools, but focused specifically on database-backed tools rather than client hosting or registry management.

### Sources

- <https://api.github.com/repos/googleapis/mcp-toolbox>
- <https://api.github.com/repos/googleapis/mcp-toolbox/releases>
- <https://github.com/googleapis/mcp-toolbox>
- <https://mcp-toolbox.dev/>


## Security Notes

No matching local secret-handling manifest was found for mcp-toolbox. 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-toolbox
- **Version Scheme:** 0
- **Revision:** 0
- **Conflicts With:** kahip
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - toolbox: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/to/toolbox/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- dnf - toolbox - 0.3-4.fc44: installed executable or alias match | Fedora Rawhide package metadata: toolbox from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Tool for interactive command line environments on Linux | https://containertoolbx.org/
- dnf - toolbox-tests - 0.3-4.fc44: installed executable or alias match | Fedora Rawhide package metadata: toolbox-tests from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Tests for toolbox | https://containertoolbx.org/
- pacman - toolbox - 0.3-1: installed executable or alias match | Arch Linux sync databases: toolbox from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Unprivileged development environment | https://github.com/containers/toolbox
- zypper - toolbox - 2.4+git20260421.7c75c12-1.1: installed executable or alias match | openSUSE Tumbleweed package metadata: toolbox from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Script to start a toolbox container for system debugging | https://github.com/openSUSE/microos-toolbox
- winget - Japplis.Toolbox: installed executable or alias match | Windows Package Manager source index: Japplis.Toolbox from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [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.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [cql](https://www.automicvault.com/pkg/brew/cql/) - Shares av.db curated category or tags: cli, data, databases, sql.
- [h2](https://www.automicvault.com/pkg/brew/h2/) - Shares av.db curated category or tags: cli, data, databases, sql.
- [mcp-server-chart](https://www.automicvault.com/pkg/brew/mcp-server-chart/) - Shares av.db curated category or tags: cli, data, mcp.
- [apache-geode](https://www.automicvault.com/pkg/brew/apache-geode/) - Shares av.db curated category or tags: cli, data, databases.
- [cassandra](https://www.automicvault.com/pkg/brew/cassandra/) - Shares av.db curated category or tags: cli, data, databases.
- [cdb](https://www.automicvault.com/pkg/brew/cdb/) - Shares av.db curated category or tags: cli, data, databases.
- [check_postgres](https://www.automicvault.com/pkg/brew/check-postgres/) - Shares av.db curated category or tags: cli, data, databases.
- [dolphie](https://www.automicvault.com/pkg/brew/dolphie/) - Shares av.db curated category or tags: cli, data, databases.
- [mdbtools](https://www.automicvault.com/pkg/brew/mdbtools/) - Local package facts share a topical domain. Shared terms: access, cli, data, databases, sql.
- [octosql](https://www.automicvault.com/pkg/brew/octosql/) - Local package facts share a topical domain. Shared terms: cli, data, databases, sql.

## Combined YAML source

View the package source record on GitHub. [combined/mcp-toolbox.yml](https://github.com/automic-vault/db/blob/main/combined/mcp-toolbox.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
