Production-grade Postgres MCP with index advice, EXPLAIN, and health checks.
- Home
- Top MCPs for Databases
- Google MCP Toolbox
Google MCP Toolbox
Google-published MCP server for databases — one Go binary speaks Postgres, MySQL, BigQuery, Spanner, AlloyDB, Snowflake, ClickHouse, MongoDB, Redis, and more.
Quick answer
What it does
Runs as a single Go binary (or container) that connects to one or more databases via a `tools.yaml` config and exposes them as MCP tools — prebuilt schema/query tools plus user-defined custom tools per source.
Best for
- Multi-database agent workflows
- Declarative `tools.yaml` query control
- Google Cloud-native data (AlloyDB, BigQuery, Spanner, Firestore)
- NL2SQL and RAG over enterprise data sources
Not for
- Single-database setups already served by a per-DB MCP
- Workflows where ad-hoc unconstrained SQL is required (use a per-DB MCP with read-only credentials)
Setup recipe
Pick your client, then follow the three steps.
- 1
Install
claude_desktop_config.jsonjson{ "mcpServers": { "google-mcp-toolbox": { "command": "brew", "args": [ "install", "mcp-toolbox", "&&", "toolbox", "--tools-file", "tools.yaml" ] } } }Paste under mcpServers. Fully quit and reopen Claude after editing.
CLI or .mcp.jsonshellclaude mcp add google-mcp-toolbox -- brew install mcp-toolbox && toolbox --tools-file tools.yamlRun from your repo. Commit .mcp.json to share with your team.
.cursor/mcp.jsonjson{ "mcpServers": { "google-mcp-toolbox": { "command": "brew", "args": [ "install", "mcp-toolbox", "&&", "toolbox", "--tools-file", "tools.yaml" ] } } }Global path: ~/.cursor/mcp.json. Reload window after editing.
.vscode/mcp.jsonjsonc{ "servers": { "google-mcp-toolbox": { "command": "brew", "args": [ "install", "mcp-toolbox", "&&", "toolbox", "--tools-file", "tools.yaml" ] } } }VS Code uses the "servers" key (not "mcpServers").
~/.codeium/windsurf/mcp_config.jsonjson{ "mcpServers": { "google-mcp-toolbox": { "command": "brew", "args": [ "install", "mcp-toolbox", "&&", "toolbox", "--tools-file", "tools.yaml" ] } } }Open via Cascade → hammer icon → Configure.
cline_mcp_settings.jsonjson{ "mcpServers": { "google-mcp-toolbox": { "command": "brew", "args": [ "install", "mcp-toolbox", "&&", "toolbox", "--tools-file", "tools.yaml" ] } } }Open via the Cline sidebar → MCP Servers → Edit.
~/.continue/config.jsonjson{ "experimental": { "modelContextProtocolServers": [ { "transport": { "type": "stdio", "command": "brew", "args": [ "install", "mcp-toolbox", "&&", "toolbox", "--tools-file", "tools.yaml" ] } } ] } }Continue uses modelContextProtocolServers with a transport block.
~/.codex/config.tomlshell# ~/.codex/config.toml [mcp_servers.google-mcp-toolbox] command = "brew" args = [ "install", "mcp-toolbox", "&&", "toolbox", "--tools-file", "tools.yaml", ]Codex uses TOML. Each server is a [mcp_servers.<name>] subtable.
~/.config/zed/settings.jsonjsonc{ "context_servers": { "google-mcp-toolbox": { "command": { "path": "brew", "args": [ "install", "mcp-toolbox", "&&", "toolbox", "--tools-file", "tools.yaml" ] } } } }Zed calls them "context_servers". Settings live-reload on save.
ChatGPT → Apps directorynoneGoogle MCP Toolbox doesn't ship a hosted HTTPS endpoint today. ChatGPT supports remote MCP servers only — to use this server in ChatGPT you'll need to deploy it to a public HTTPS URL first (e.g. via Cloudflare Workers or Vercel) or wait for an official remote build.
- 2
Set required secrets
No credentials required — this MCP runs over stdio without authentication.
- 3
Try a minimum working prompt
Cross-database lookup: Postgres user + BigQuery activity
Using the MCP Toolbox, look up user 42 in Postgres (`get_user_by_id`), then pull their last 30 days of events from BigQuery (`get_recent_events`). Return name, email, event count, and the top three event types.Tested with: Claude Code, Cursor, Claude Desktop.
Tools & permissions
Tools list pending verification. The server exposes tools over MCP; we haven’t yet parsed its capability manifest into this page. Check the GitHub repo for the authoritative list.
Security & scope
- Access scope
- Read + write
- Sandbox
- Tools are explicitly declared in `tools.yaml`. Only the queries you define are callable by the agent — there is no implicit `execute_sql` unless you add it. Connections use the DB host's native auth (Postgres roles, BigQuery IAM, MongoDB users, etc.).
- Gotchas
- A generic `execute_sql` tool in `tools.yaml` is the same risk surface as direct DB access — only add it for read-only DB users on dev/staging.
- IAM-bound Google Cloud sources inherit the service account or user credentials of the running binary — scope the binary's identity tightly, not your personal account.
- The streamable-HTTP endpoint (`:5000/mcp`) binds to localhost by default; if you expose it on a network, gate it behind auth at the network or proxy layer.
Agent prompt pack
— copy into Claude, Cursor, or ChatGPT.Recommend the best MCP servers for [task: e.g. databases work] in [client: Claude]. Constraints: - Prefer tools that are [official | open-source | read-only] — pick what matters for my use case. - Exclude MCPs that require [e.g. a paid plan, OAuth-only flows, remote-only transport]. - Return at most 3 picks, ranked. For each pick include: 1. One-sentence rationale. 2. The ready-to-paste install snippet for my client. 3. Any required secrets I need to create before installing. Cross-check the top-mcps.com listing: https://top-mcps.com/top-mcps-for-databases
Compare Google MCP Toolbox MCP vs [Postgres MCP Pro MCP] for the following job: [describe the job, e.g. "let an agent create GitHub issues on bug triage"]. Judge them on: - Setup time and complexity (what a new user hits first). - Auth model (none / API key / OAuth 2.1) and credential risk. - Transport (stdio / Streamable HTTP / SSE) and where the server runs. - Required secrets and the blast radius if they leak. - Operational risk in an unattended agent loop. - Which one is "good enough" for a weekend prototype vs. production. End with one sentence: which should I pick for my scenario, which is: [my scenario]. References: - https://top-mcps.com/mcp/google-mcp-toolbox - top-mcps.com listing for Postgres MCP Pro
Install the Google MCP Toolbox MCP server for my [client: Claude] at the default config path for that client. Use the exact install snippet published at https://top-mcps.com/mcp/google-mcp-toolbox (fetch https://top-mcps.com/mcp/google-mcp-toolbox.json for the canonical server.json if you can read URLs). Before finishing: 1. Create the required secrets (no secrets) and put them in the appropriate env block — do not hard-code them. 2. Restart or reload the client so it picks up the new server. 3. Verify the server is connected (green / running state) and at least one tool is listed. 4. If anything fails, read the client's MCP logs and report the exact error — do not silently retry. Confirm when done and list the tools the server now exposes.
Frequently asked questions
What changed
— 2 updates tracked.Refreshed install snippets and fact sheet; verified for 2026.
Initial directory listing.
More Databases MCPs
Other tools in the same category worth evaluating.
Compared with Google MCP Toolbox
Side-by-side breakdowns for the choices people most often weigh against this MCP.
Exploring Top MCPs for Databases? See all Databases MCPs →
