1. Home
  2. MCP Toolbox for Databases
  3. MCP Toolbox for Databases for Claude Desktop: Setup & Config

Data as of

MCP Toolbox for Databases for Claude Desktop: Setup & Config

Claude Desktop: MCP Toolbox for Databases connects agents and IDEs to enterprise data through prebuilt tools or custom query definitions.

What you can do with MCP Toolbox for Databases in Claude Desktop

Use one database-tool framework for exploratory assistants and deliberately scoped production queries.

  • Explore database schemas from a coding assistant.
  • Run database queries through prebuilt MCP tools.
  • Define parameterized custom operations for production agents.

Before you start: MCP Toolbox for Databases in Claude Desktop

  • An MCP-compatible client
  • npx for this execution method
  • A PostgreSQL database for this example
  • Database-specific connection settings from the prebuilt reference

This is the README's prebuilt PostgreSQL example. Exact database connection environment variables are not stated in the supplied README, so none are invented here. Binaries and containers are recommended for a more standard installation. The repository is now named mcp-toolbox.

MCP Toolbox for Databases Claude Desktop configuration

  1. Choose Claude Desktop configuration scope

    For MCP Toolbox for Databases, open macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json. Merge under mcpServers via Settings → Developer → Edit Config when available.

  2. Add MCP Toolbox for Databases to Claude Desktop

    Use the genai-toolbox entry below in mcpServers. Keep MCP Toolbox for Databases's documented stdio connection fields and your other Claude Desktop entries.

  3. Check MCP Toolbox for Databases in Claude Desktop

    MCP Toolbox for Databases: Fully quit and reopen Claude Desktop; check developer diagnostics.

Config file · macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

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

MCP Toolbox for Databases tools available to Claude Desktop

MCP Toolbox for Databases's stored tool list documents 2 tools; compare it with Claude Desktop's connected tool list, because the stored list is not a live check.

list_tables

When Claude Desktop requests list_tables from MCP Toolbox for Databases, review the action before approving it.

Discover database tables through a prebuilt generic tool.

execute_sql

When Claude Desktop requests execute_sql from MCP Toolbox for Databases, review the action before approving it.

MCP Toolbox for Databases: full stored tool descriptions

Troubleshooting MCP Toolbox for Databases in Claude Desktop

  • Fully quit and reopen Claude Desktop for MCP Toolbox for Databases. If npx @toolbox-sdk/server (Node.js/npm) is missing, check the desktop process's PATH, which may differ from your terminal.
  • MCP Toolbox for Databases uses stdio here: Claude Desktop must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
  • Known limitation: Connection configuration is database-specific and requires separate reference details.
  • Known limitation: The README characterizes npm execution as convenience-oriented rather than the most reliable installation.
  • Known limitation: Custom tools require source and query definitions.
  • General Claude Desktop troubleshooting lives in the /clients/claude-desktop guide.

MCP Toolbox for Databases — details. Claude Desktop guide

Frequently asked questions

Claude Desktop loads MCP Toolbox for Databases from claude_desktop_config.json: ~/Library/Application Support/Claude/ on macOS, or %APPDATA%\Claude\ on Windows. Open it via Settings → Developer → Edit Config when available.

Claude Desktop's genai-toolbox example uses stdio.

MCP Toolbox for Databases's Claude Desktop configuration invokes npx @toolbox-sdk/server (Node.js/npm).

MCP Toolbox for Databases's stored list contains 2 tools, including list_tables, execute_sql. Compare those names with Claude Desktop's connected tool list; the stored list is not a live check.

No. The README also lists systems such as PostgreSQL, MySQL, Oracle, MongoDB, Redis, Neo4j, and Snowflake.

Prebuilt tools provide generic access, while custom tools define source connections, parameters, and operations in configuration such as tools.yaml.