# MCP Toolbox for Databases

> MCP Toolbox for Databases is an open-source MCP server for databases. Open source database MCP server with prebuilt tools and a framework for custom ones. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/googleapis/mcp-toolbox
- **MCP Registry name:** io.github.googleapis/mcp-toolbox
- **Categories:** databases, developer tools
- **Listing updated:** 2026-11-15

## About

The project started life as the Gen AI Toolbox for Databases and was renamed when it aligned with MCP. It does two jobs. Run with a `--prebuilt=<database>` flag and it gives an MCP client generic tools such as `list_tables` and `execute_sql` for a long list of engines, among them AlloyDB, BigQuery, Cloud SQL, Spanner, Firestore, PostgreSQL, MySQL, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, ClickHouse, Neo4j and Snowflake. A toolset suffix such as `postgres/data` loads only part of the tool group.

The second job is a custom tools framework. A `tools.yaml` file declares sources, tools with typed parameters and fixed SQL statements, toolsets and prompts, so production agents see only structured, parameterised actions instead of free-form SQL. The README says it handles connection pooling, IAM-based authentication and OpenTelemetry metrics and tracing.

SDKs for Python, JavaScript, Go and Java let applications built on LangChain, LlamaIndex or Google's Agent Development Kit load the same tools. The registry lists an OCI image served over streamable HTTP, and the README notes a managed Google Cloud MCP option for those who prefer it.

## Features

- **Prebuilt database tools:** Start with one flag to get schema exploration and SQL execution for a chosen engine.
- **Broad engine support:** Covers Google Cloud databases plus PostgreSQL, MySQL, Oracle, MongoDB, Redis, Snowflake and more.
- **Custom tools in YAML:** Declare sources, parameterised statements, toolsets and prompts in tools.yaml.
- **Pooling and IAM auth:** Connection pooling and integrated authentication are handled by the server.
- **OpenTelemetry built in:** Metrics and tracing come out of the box.
- **Client SDKs:** Python, JavaScript, Go and Java SDKs load tools into agent frameworks.

## Good for

- Explore a database schema and run queries from an IDE assistant
- Expose a vetted set of parameterised queries to a production agent
- Connect an agent to BigQuery, AlloyDB or Spanner
- Add database tools to a LangChain or LlamaIndex application
- Trace and monitor agent database calls with OpenTelemetry

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-toolbox -- docker run -i --rm us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:1.17.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:1.17.0"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:1.17.0"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-toolbox": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:1.17.0"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:1.17.0"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:1.17.0"
      ]
    }
  }
}
```

## Tools

- `list_tables`: List tables in the connected database
- `execute_sql`: Run a SQL statement against the connected database

## FAQ

### Which databases are supported?

The README lists AlloyDB, BigQuery, Cloud SQL, Spanner, Firestore, PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake, Trino and more.

### How do I restrict what an agent can run?

Define custom tools in tools.yaml with fixed statements and typed parameters instead of using the generic SQL tool.

### What licence is it under?

The README badge shows Apache 2.0.

### Was it called something else before?

Yes. It was originally Gen AI Toolbox for Databases, at the genai-toolbox repository.

### Is MCP Toolbox for Databases free?

Yes. MCP Toolbox for Databases is open source, so you can use and self-host it for free.

### How do I add MCP Toolbox for Databases to Claude Code?

Run this command in your terminal: claude mcp add mcp-toolbox -- docker run -i --rm us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:1.17.0

### What are the best alternatives to MCP Toolbox for Databases?

The closest alternatives to MCP Toolbox for Databases are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-toolbox-for-databases-2
