Skip to main content
mcpSource-backed
MCP Toolbox for Databases logo

MCP Toolbox for Databases

Open source MCP server and tool framework from Google for connecting AI agents, IDEs, and applications to databases through prebuilt or custom database tools.

by Google · submitted by oktofeesh1·added 2026-06-05·
Review first review before installing

Open the source and read safety notes before installing.

Citation facts

Source-backed facts for citing this resource, derived directly from the registry — also available as plain text for AI assistants.

Source URLs
https://mcp-toolbox.dev/documentation/introduction/, https://github.com/googleapis/mcp-toolbox
Brand
MCP Toolbox for Databases
Brand domain
mcp-toolbox.dev
Brand asset source
brandfetch
Safety notes
Database tools can expose sensitive schemas and data, and some custom tools can modify data if configured that way., Prefer least-privilege accounts, read-only roles for exploration, query limits, and approved toolsets., Review every `tools.yaml` statement, parameter, source, and toolset before giving it to an agent., Avoid broad `execute_sql` access in production; expose structured, parameterized tools where possible., Query loops can create high database load, unexpected cloud costs, lock contention, or noisy audit logs.
Privacy notes
Schema names, table names, query text, query results, connection metadata, and business data may pass through the MCP server and AI client., Database passwords, IAM credentials, service account keys, and connection strings are secrets and should never be committed or pasted into prompts., Logs, traces, and metrics can include tool names, query metadata, error messages, and database identifiers.
Author
Google
Submitted by
oktofeesh1
Claim status
unclaimed
Last verified
2026-06-05

Decision playbook

Review trust signals before you adopt

Signals are present but mixed. Use the checklist below to confirm the source and operational safety for your environment.

Compare context
Selected

0

Current score

63

Baseline

Delta

No baseline selected

No major trust-signal divergence detected in the current selection.

Source and provenance checks

Needs review

Confirm ownership and provenance before trusting install instructions.

  • Source link availableRequired

    Open the canonical repository and verify ownership.

    Done
  • Source provenance statusRequired

    Marked as source-backed.

    Done
  • Metadata reviewed

    No reviewed flag detected in metadata.

    Pending

Safety and privacy checks

Complete

Validate risk disclosures before installation or API wiring.

  • Safety notes presentRequired

    Review the listed safety guidance before running commands.

    Done
  • Privacy notes presentRequired

    Review data handling notes before connecting accounts or secrets.

    Done
  • Trust level risk gateRequired

    Trust level does not block evaluation.

    Done

Package and install checks

Needs review

Check package metadata and artifact integrity signals.

  • Install payload available

    Install or copy payload is available for review.

    Done
  • Package verification flag

    No package verification flag provided.

    Pending
  • Checksum metadata

    No checksum provided for downloaded artifact.

    Pending

Compare-driven decision checks

Needs review

Use compare context to validate trade-offs before adoption.

  • Compare tray has multiple entries

    Add at least one more entry to compare trust differences.

    Pending
  • Baseline comparison available

    No baseline peer selected yet.

    Pending
  • Diverging trust signals identified

    No major trust-signal divergence found.

    Pending

Setup at a glance

CLI install

Copy-ready — paste the snippet to get started.

15 minutes

Adoption plan

Balanced adoption plan

Current risk score 24/100. Use staged verification before broader rollout.

Risk 24

Pre-adoption checks

Validate source and review signals before any execution.

  • Confirm source provenanceRequired

    Source URL/provenance metadata is present.

    Done
  • Confirm metadata review state

    No review metadata found; increase manual validation.

    Pending
  • Verify install payload

    Install/config payload exists and can be inspected.

    Done

Security checks

Confirm safety, privacy, and package integrity signals.

  • Review safety notesRequired

    Safety notes are present.

    Done
  • Review privacy notesRequired

    Privacy notes are present.

    Done
  • Verify package integrity metadata

    No package verification/checksum metadata.

    Pending

Rollout

Adopt in controlled steps based on the selected plan.

  • Run in isolated sandbox firstRequired

    Use a constrained sandbox and observe behavior across multiple tasks.

    Pending
  • Roll out graduallyRequired

    Roll out to a small cohort before wider usage.

    Pending
  • Set monitoring and fallback

    Define rollback path and monitor errors after adoption.

    Pending

Evidence readiness

Evidence readiness matrix · balanced

Missing required evidence: Metadata review. Risk score 31.

Risk 31

Source provenance

Present

Source repository/provenance is listed.

Required in this preset

Metadata review

Missing

Review metadata is missing.

Required in this preset

Safety notes

Present

Safety notes are present.

Required in this preset

Privacy notes

Present

Privacy notes are present.

Optional in this preset

Package integrity

Missing

Package integrity metadata is missing.

Optional in this preset

Install payload

Present

Install payload is available.

Required in this preset

Required gaps: Metadata review

Decision timeline

Decision timeline · balanced

Blocking gaps: Check metadata review status. Risk 28.

Risk 28

triage

Confirm source provenanceRequired

Source/provenance metadata is available.

Done

triage

Check metadata review statusRequired

Review metadata is missing.

Pending

verify

Review safety notesRequired

Safety notes are available.

Done

verify

Review privacy notes

Privacy notes are available.

Done

verify

Validate package integrity metadata

Package integrity metadata is missing.

Pending

rollout

Verify install payload and commandsRequired

Install payload is available.

Done

Blockers: Check metadata review status

Prerequisite readiness

Prerequisite readiness

5 prerequisites to line up before setup. Have accounts and credentials ready first. Includes a review or approval gate.

0/5 ready
Account & credentials1Install & runtime2Configuration1Review & approval115 minutes

Safety & privacy surface

Safety & privacy surface

5 safety and 3 privacy notes across 5 risk areas. Review closely: credentials & tokens, permissions & scopes.

5 areas
  • SafetyGeneralDatabase tools can expose sensitive schemas and data, and some custom tools can modify data if configured that way.
  • SafetyPermissions & scopesPrefer least-privilege accounts, read-only roles for exploration, query limits, and approved toolsets.
  • SafetyGeneralReview every `tools.yaml` statement, parameter, source, and toolset before giving it to an agent.
  • SafetyExecution & processesAvoid broad `execute_sql` access in production; expose structured, parameterized tools where possible.
  • SafetyData retentionQuery loops can create high database load, unexpected cloud costs, lock contention, or noisy audit logs.
  • PrivacyGeneralSchema names, table names, query text, query results, connection metadata, and business data may pass through the MCP server and AI client.
  • PrivacyCredentials & tokensDatabase passwords, IAM credentials, service account keys, and connection strings are secrets and should never be committed or pasted into prompts.
  • PrivacyData retentionLogs, traces, and metrics can include tool names, query metadata, error messages, and database identifiers.

Safety notes

  • Database tools can expose sensitive schemas and data, and some custom tools can modify data if configured that way.
  • Prefer least-privilege accounts, read-only roles for exploration, query limits, and approved toolsets.
  • Review every `tools.yaml` statement, parameter, source, and toolset before giving it to an agent.
  • Avoid broad `execute_sql` access in production; expose structured, parameterized tools where possible.
  • Query loops can create high database load, unexpected cloud costs, lock contention, or noisy audit logs.

Privacy notes

  • Schema names, table names, query text, query results, connection metadata, and business data may pass through the MCP server and AI client.
  • Database passwords, IAM credentials, service account keys, and connection strings are secrets and should never be committed or pasted into prompts.
  • Logs, traces, and metrics can include tool names, query metadata, error messages, and database identifiers.

Prerequisites

  • Node.js and npx for the npm server path, or another documented Toolbox runtime.
  • Database credentials scoped to the exact database, schema, and permissions needed.
  • Environment variables or secret storage for database connection settings.
  • A reviewed prebuilt database target or `tools.yaml` file before exposing tools to an agent.
  • MCP client such as Claude Code, Codex, Gemini CLI, Google Antigravity, or another compatible host.

Schema details

Install type
cli
Troubleshooting
No
Source repository stats
Scope
Source repo
Collection metadata
Estimated setup
15 minutes
Difficulty
intermediate
Full copyable content
{
  "mcpServers": {
    "toolbox-postgres": {
      "command": "npx",
      "args": ["-y", "@toolbox-sdk/server", "--prebuilt=postgres", "--stdio"]
    }
  }
}

About this resource

Content

MCP Toolbox for Databases is an open source MCP server and framework for database-backed tools. It can expose prebuilt database tools for MCP clients or serve custom tools defined in a tools.yaml file. The project documents support for Google Cloud databases and many other systems, including PostgreSQL, MySQL, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake, and Trino.

Use it when an agent needs database context, schema exploration, or pre-approved database operations without hand-building an MCP server for each database.

Source Review

These sources were reviewed on 2026-06-05. Prefer the live documentation for supported database lists, prebuilt tool names, runtime options, authentication support, and configuration schema.

Features

  • Prebuilt MCP tools for common database exploration and querying workflows.
  • Custom database tools defined through tools.yaml.
  • Support for parameterized SQL tools, toolsets, prompts, and source definitions.
  • Integrated authentication patterns, connection pooling, and OpenTelemetry observability.
  • Compatibility with MCP clients such as Claude Code, Codex, Gemini CLI, Google Antigravity, and other MCP-capable hosts.
  • SDKs for application integration in Python, JavaScript/TypeScript, Go, and Java.

Installation

For a basic prebuilt PostgreSQL setup:

claude mcp add toolbox-postgres -- npx -y @toolbox-sdk/server --prebuilt=postgres --stdio

For JSON-based MCP clients:

{
  "mcpServers": {
    "toolbox-postgres": {
      "command": "npx",
      "args": ["-y", "@toolbox-sdk/server", "--prebuilt=postgres", "--stdio"]
    }
  }
}

For custom tools, create a reviewed tools.yaml and run the server with:

npx @toolbox-sdk/server --config tools.yaml

Use Cases

  • Let an agent inspect database schemas while generating data-aware application code.
  • Expose read-only SQL exploration in a development database.
  • Build production-ready, parameterized database tools instead of broad query access.
  • Add semantic search or structured data tools to an agent runtime.
  • Centralize database access patterns behind a reviewed MCP tool configuration.

Safety and Privacy

Database MCP servers need explicit guardrails. Use least-privilege credentials, prefer read-only accounts for exploration, limit exposed toolsets, and keep production write operations behind reviewed custom tools. Avoid giving an agent unbounded query access to sensitive or expensive databases.

Never commit database credentials, IAM secrets, service account keys, or connection strings. Treat schemas, row samples, query errors, and trace metadata as potentially sensitive.

Duplicate Check

Existing entries cover specific database MCP servers such as BigQuery, PostgreSQL, MongoDB, Snowflake, ClickHouse, Redis, and Qdrant. This entry covers Google's broader MCP Toolbox for Databases project and its reusable server/tool framework.

Source citations

Add this badge to your README

Show that MCP Toolbox for Databases is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.

Listed on HeyClaude
[![Listed on HeyClaude](https://heyclau.de/badge/mcp/mcp-toolbox-for-databases.svg)](https://heyclau.de/entry/mcp/mcp-toolbox-for-databases)

How it compares

MCP Toolbox for Databases side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.

1 trust signal differ across this comparison (Submitter).

Field

Open source MCP server and tool framework from Google for connecting AI agents, IDEs, and applications to databases through prebuilt or custom database tools.

Open dossier

MCP support in Azure Data API Builder for exposing configured database entities as MCP tools, including entity discovery and DML operations over Azure databases and supported on-premises data stores.

Open dossier

Official Neon MCP server that connects Claude and other MCP clients to Neon Postgres projects, branches, schemas, SQL queries, migrations, performance tuning, Neon Auth, Data API setup, and Neon documentation through a hosted Streamable HTTP endpoint.

Open dossier

Connect Claude to Teradata — list databases and tables, inspect DDL, run SQL queries, preview data, analyze column quality, and explore DBA diagnostics — with the official Teradata MCP server supporting optional ML tool expansion via the teradataml Python package.

Open dossier
Next steps
Trust
Review statusNot reviewedNot reviewedNot reviewedNot reviewed
Package trustPackage not verifiedPackage not verifiedPackage not verifiedPackage not verified
Source provenanceSource-backedSource-backedSource-backedSource-backed
SubmitterDiffersoktofeesh1oktofeesh1oktofeesh1
Install riskReview firstReview firstReview firstReview first
Notes Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓
BrandMCP Toolbox for Databases logoMCP Toolbox for DatabasesData API Builder logoData API Builder
Categorymcpmcpmcpmcp
SourceSource-backedSource-backedSource-backedSource-backed
AuthorGoogleAzureNeonTeradata
Added2026-06-052026-06-062026-06-042026-06-18
Platforms
Harness
Source repo
Safety notesDatabase tools can expose sensitive schemas and data, and some custom tools can modify data if configured that way. Prefer least-privilege accounts, read-only roles for exploration, query limits, and approved toolsets. Review every `tools.yaml` statement, parameter, source, and toolset before giving it to an agent. Avoid broad `execute_sql` access in production; expose structured, parameterized tools where possible. Query loops can create high database load, unexpected cloud costs, lock contention, or noisy audit logs.Data API Builder MCP tools can expose database entity metadata and perform DML operations depending on DAB configuration and permissions. Built-in tools include entity discovery and record read, create, update, delete, aggregate, and execute-style workflows in the MCP source tree. The upstream README still labels endpoint support as coming soon while source, samples, and testing docs expose MCP behavior; verify the exact release before production use. Use least-privilege roles, disable DML tools where not required, and require approval before write, delete, execute, or stored-procedure operations. Do not connect MCP clients to production databases without backups, audit logging, query limits, and rollback procedures.Neon documents the MCP server as intended for development and testing only, and warns users to review and authorize LLM-requested actions before execution. Full-access mode can create and delete projects, create and delete branches, reset branches from parents, run SQL, run SQL transactions, prepare and complete migrations, tune queries, provision Neon Auth, and provision the Neon Data API. Prefer OAuth read-only mode or `readonly=true` for exploration. In read-only mode, write tools are unavailable and SQL execution is constrained to read-only queries. Use `projectId` scoping and tool category filters when an agent should work inside one project or only use schema, querying, docs, or branch tools. API keys created by `neonctl init` or stored in MCP headers grant Neon account or organization access. Revoke unused keys, avoid committing bearer tokens, and do not expose API keys in prompts, logs, screenshots, or shared config files. Database rows, docs pages, migration output, SQL errors, and query plans are model-visible context. Treat returned data as untrusted input that may contain prompt injection, stale assumptions, secrets, or customer records. Migration and query-tuning workflows use temporary branches before applying changes, but the final complete actions can affect the original branch and should require explicit human review. The deprecated SSE endpoint exists for clients without Streamable HTTP support; prefer the documented `https://mcp.neon.tech/mcp` endpoint when the client supports it.The `base_query` tool executes arbitrary SQL on your Teradata system — only connect with credentials scoped to the minimum required permissions. Row limits (`DEFAULT_ROW_LIMIT`, `MAX_ROW_LIMIT`) prevent accidental full-table scans returning millions of rows; leave defaults in place unless you need larger result sets.
Privacy notesSchema names, table names, query text, query results, connection metadata, and business data may pass through the MCP server and AI client. Database passwords, IAM credentials, service account keys, and connection strings are secrets and should never be committed or pasted into prompts. Logs, traces, and metrics can include tool names, query metadata, error messages, and database identifiers.Entity metadata can expose database names, table names, view names, stored procedure names, field names, key fields, relationships, permissions, and role design. Read and DML tool calls can expose or change customer records, internal data, regulated fields, identifiers, audit fields, and business workflow state. Connection strings, role headers, MCP URLs, logs, request bodies, result payloads, and MCP transcripts can contain sensitive operational or personal data. Redact database values, connection details, entity names, role names, and query results before sharing prompts, screenshots, logs, or generated notes.Tool results can expose Neon organization IDs, project IDs, branch IDs, compute endpoints, database names, table names, schemas, SQL text, query results, query plans, slow query details, connection strings, documentation content, and Neon Console links. OAuth authorization can disclose the Neon account identity and grants the connected MCP client access according to the approved scopes and URL parameters. API-key setup stores bearer credentials in MCP client configuration or process arguments when configured that way; protect local config files, shell history, CI variables, and agent transcripts. Generated migrations, SQL errors, query tuning suggestions, logs, client debug output, and AI chat transcripts can retain database schema and sample data outside Neon. ChatGPT connectors, hosted IDEs, remote agents, MCP proxies, and other clients may have separate logging, retention, connector trust, and data-use policies from Neon. Connection string tools may return credentials or connection details for a Neon database. Avoid exposing those values to untrusted clients or shared conversations.Query results, schema definitions, DDL, and session/system metadata from your Teradata instance are surfaced in Claude's context. Your database credentials are embedded in the `DATABASE_URI` — keep it in the MCP config env and never commit it to version control.
Prerequisites
  • Node.js and npx for the npm server path, or another documented Toolbox runtime.
  • Database credentials scoped to the exact database, schema, and permissions needed.
  • Environment variables or secret storage for database connection settings.
  • A reviewed prebuilt database target or `tools.yaml` file before exposing tools to an agent.
  • Reviewed Azure Data API Builder configuration with the MCP runtime section enabled.
  • Supported Azure or on-premises database connection configured through DAB.
  • DAB entity permissions, role headers, DML tool flags, and per-entity MCP settings reviewed before exposing tools.
  • MCP client support for the transport used by the deployed DAB server.
  • Neon account with access to the projects, branches, databases, organizations, or shared projects Claude should inspect or manage.
  • MCP-capable client that supports remote Streamable HTTP MCP servers, OAuth, `mcp-remote`, or Neon-supported configuration through `add-mcp`.
  • Authentication plan using Neon OAuth for local clients, an API key for remote or headless agents, or `neonctl init` when intentionally creating a local API key and editor configuration.
  • Access-control plan for OAuth scopes, `readonly=true`, project scoping with `projectId`, tool categories, organization access, and API key ownership.
  • A Teradata database instance accessible from your network.
  • A Teradata username and password with appropriate query permissions.
  • Python with `uvx` available.
  • An MCP client such as Claude Code or Claude Desktop.
Install
claude mcp add toolbox-postgres -- npx -y @toolbox-sdk/server --prebuilt=postgres --stdio
Enable the DAB runtime MCP section, start Data API Builder with the reviewed configuration, and connect an MCP client to the configured MCP path.
npx add-mcp https://mcp.neon.tech/mcp
claude mcp add teradata -e DATABASE_URI="teradata://username:password@host:1025/databasename" -- uvx teradata-mcp-server
Config
{
  "mcpServers": {
    "toolbox-postgres": {
      "command": "npx",
      "args": ["-y", "@toolbox-sdk/server", "--prebuilt=postgres", "--stdio"]
    }
  }
}
Manual-only setup:
"mcp": {
  "enabled": true,
  "path": "/mcp"
}
{
  "mcpServers": {
    "neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp?readonly=true&projectId=PROJECT_ID"
    }
  }
}
{
  "mcpServers": {
    "teradata": {
      "command": "uvx",
      "args": ["teradata-mcp-server"],
      "env": {
        "DATABASE_URI": "teradata://username:password@host:1025/databasename",
        "DEFAULT_ROW_LIMIT": "1000",
        "MAX_ROW_LIMIT": "50000"
      }
    }
  }
}
Citations
ClaimUnclaimedUnclaimedUnclaimedUnclaimed
Open 4 picks in the interactive comparison tool

Related guides

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.