# MCP Toolbox for Databases [Official] [Health: Active]

**Category:** 🗄️ Databases  
**Repository:** https://github.com/googleapis/mcp-toolbox  
**GitHub Stars:** 16930  
**Views:** 11  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-toolbox-for-databases

## Description
MCP Toolbox for Databases enables your agent to connect to your database.

## Claude Desktop Quick Installation
No generated config for this server: it installs through its own setup steps.

The project's own setup steps (from https://github.com/googleapis/mcp-toolbox), copied verbatim. Run them in order; they are not an mcpServers config.

1. Start the server:

```sh
./toolbox --ui
```

## Documentation

## What MCP Toolbox for Databases does

MCP Toolbox for Databases exposes database access to MCP clients and agent applications. It has two main operating modes: prebuilt tools for immediate database connectivity, and a configuration framework for defining narrower tools for production use.

Prebuilt configurations include generic capabilities such as listing tables and executing SQL. They can support data exploration, schema discovery, database-aware code generation, and natural-language interactions with data. Supported systems span Google Cloud services such as AlloyDB, BigQuery, Cloud SQL, Spanner, Firestore, and Knowledge Catalog, along with databases including PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake, and Trino.

## How it works

An MCP client starts Toolbox and communicates with it using the Model Context Protocol. The prebuilt mode is selected with a database name, such as `--prebuilt=postgres`; a database-specific toolset can also be selected, for example `--prebuilt=postgres/data`.

For custom deployments, a `tools.yaml` file describes the data sources available to Toolbox and the actions agents may perform. A source contains connection details for a database. A tool identifies its type, source, parameters, description, and query or other action. Toolsets group related tools so different agents or applications can load different capabilities. Prompt resources can define prompts for LLM interactions.

The server includes connection pooling, integrated authentication including IAM, and OpenTelemetry support for metrics and tracing.

## Setup and configuration

Add Toolbox to an MCP client's configuration and launch it with the package's server command. A stdio setup uses `npx` with the `@toolbox-sdk/server` package, a prebuilt database selection, and the `--stdio` option. The database connection must then be configured with the appropriate settings for the selected prebuilt integration.

Custom setups use a YAML file, passed with `--config tools.yaml`. The file can contain `source`, `tool`, `toolset`, and `prompt` resources. A PostgreSQL source, for example, can define a host, port, database, user, and password; a SQL tool can reference that source and expose a parameterized statement.

Toolbox can also be run through other execution methods, including Docker or binaries.

## Tools and capabilities

- Load generic tools for a selected database or toolset.
- List database tables with the prebuilt `list_tables` capability.
- Execute SQL through the prebuilt `execute_sql` capability.
- Define parameterized, source-specific SQL tools.
- Group tools into agent- or application-specific toolsets.
- Support structured queries, restricted access patterns, semantic search, and NL2SQL-oriented custom tools.
- Provide database-aware schema exploration and code-generation workflows.
- Collect metrics and traces through OpenTelemetry.

## Limitations and notes

Prebuilt tools and available capabilities vary by database integration and selected toolset. Custom tools require configuration in `tools.yaml`, including the sources they can access and the actions they expose. The project was renamed from Gen AI Toolbox for Databases to MCP Toolbox for Databases; existing local repository remotes may need to be updated when moving to the renamed repository.

_Full upstream README: https://allmcps.com/mcp/mcp-toolbox-for-databases/readme_

