LibreAI / AI Agents / mcp-toolbox
// agents · googleapis/mcp-toolbox

mcp-toolbox

Google's MCP Toolbox for Databases - give agents safe, structured access to your data

★ 16.6k stars⑂ 1.8k forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

mcp-toolbox is an open-source ai agents project by googleapis (googleapis/mcp-toolbox on GitHub). It has 16,624 GitHub stars and 1,753 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 8 October 2026.

GitHub stars
16,624
Forks
1,753
License
Apache-2.0
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Pick a database

    Choose the database your agent needs - prebuilt configs cover Google Cloud and popular open-source databases.

  2. Get Toolbox

    Download the binary for your OS, use the container image, or run it through npx.

  3. Configure sources and tools

    Use a prebuilt toolset with environment variables, or write a tools.yaml defining sources, tools and toolsets.

  4. Connect your MCP client

    Point Claude, an IDE or your app (via the Toolbox SDKs) at the server and run your first query tool.

// features

Why people love it

Prebuilt database tools

Instant standard tools for many databases via the --prebuilt flag, down to per-toolset granularity.

Custom tools in YAML

Define your own SQL tools, sources, toolsets, prompts and resources in a configuration file.

Broad database support

Google Cloud databases plus PostgreSQL, MySQL, MongoDB, Redis, Elasticsearch, ClickHouse, Oracle, TiDB and others per the topic list.

Multiple install routes

Run a downloaded binary, a container image, or npx @toolbox-sdk/server.

Client and SDK integration

Connect any MCP client, or embed Toolbox in your application with the Toolbox SDKs.

Built-in UI option

The server can run with a UI flag for interactive exploration of your tools.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source code from GitHub and enter the project directory.

    git clone https://github.com/googleapis/mcp-toolbox.git
    cd mcp-toolbox
  2. Run with a config

    Start the server against your tools.yaml (binary or npx route).

    npx @toolbox-sdk/server --config tools.yaml
    # or with the binary: ./toolbox --config "tools.yaml"
  3. Or use a prebuilt toolset

    Point Toolbox at a supported database with the prebuilt flag and the documented environment variables.

    # toolbox --prebuilt=postgres/data - see README Prebuilt Tools Reference for env vars
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains this project?

It is maintained by Google (googleapis) on GitHub.

Is it free to use?

Yes - MCP Toolbox is Apache-2.0 licensed and free to use.

Does it need a paid API key?

Toolbox itself needs no key; you provide your database's own credentials/connection settings, and cloud databases use their normal IAM or service-account auth.

How does it compare to alternatives?

Compared with hand-writing an MCP server per database, Toolbox gives you prebuilt, maintained toolsets and a config-driven custom-tool system from Google's team.

How do I get started?

Download the binary or use npx, run it with --prebuilt for your database or a tools.yaml, and connect your MCP client.

// keep exploring

Similar tools

AI Agents

brightdata-mcp

Bright Data's MCP server: web search, scraping, structured data and browser automation for agents (75 tools)

★ 2.7k starsMIT
View guide →
AI Agents

mcp-gateway-registry

An enterprise MCP gateway: governed, auditable tool access for agents.

★ 964 starsApache-2.0
View guide →
AI Agents

open-connector

An open-source auth gateway connecting 1,500+ SaaS providers to AI agents via SDK, CLI, MCP and HTTP.

★ 6.0k starsApache-2.0
View guide →
AI Agents

google_workspace_mcp

Control Gmail, Calendar, Docs, Sheets, Drive and more from AI — a full Google Workspace MCP server.

★ 3.3k starsMIT
View guide →
AI Agents

mcp-shrimp-task-manager

Shrimp Task Manager: an MCP server that turns natural language into structured, dependent dev tasks.

★ 2.1k starsMIT
View guide →
AI Agents

iwe

A markdown knowledge graph with LSP for editors and MCP for agents.

★ 1.7k starsApache-2.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if mcp-toolbox is not the right fit.

Get mcp-toolbox

Free and open — grab the source, star the repo, and start creating.