MCP Toolbox for Databases

Connect agents to Postgres, BigQuery, Cloud SQL, Spanner, and other databases through one YAML config file.

15,532 GitHub stars

1,200 Forks

2026-06-09 Updated

Apache-2.0 License

Install

Add MCP Toolbox for Databases to your agent

Custom tools.yaml workflow. Google also ships prebuilt database configs via --prebuilt=postgres and --stdio; see googleapis/mcp-toolbox README.

1Config location

Global: ~/.cursor/mcp.json or project: .cursor/mcp.json

2Copy this snippet

{ "mcpServers": { "toolbox": { "command": "npx", "args": ["-y", "@toolbox-sdk/server", "--config", "tools.yaml"] } } }

Add this block under mcpServers, then restart Cursor.

1Config location

Terminal: one command per server

2Copy this snippet

claude mcp add toolbox -- npx -y @toolbox-sdk/server --config tools.yaml

Run claude mcp list to verify the server is registered.

1Config location

User config: ~/.codex/config.toml

2Copy this snippet

[mcp_servers.toolbox] command = "npx" args = ["-y", "@toolbox-sdk/server", "--config", "tools.yaml"]

Codex CLI reads MCP servers from config.toml on the next run.