io.github.kalehdoo/warehouse-mcp

io.github.kalehdoo/warehouse-mcp

Production MCP server for Postgres, Oracle, Snowflake, BigQuery, Redshift, DuckDB, MotherDuck.

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "warehouse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "warehouse-mcp@0.4.2"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "WAREHOUSE_TYPE": "<your WAREHOUSE_TYPE>",
        "MCP_API_KEYS": "<your MCP_API_KEYS>",
        "MOTHERDUCK_TOKEN": "<your MOTHERDUCK_TOKEN>",
        "PG_PASSWORD": "<your PG_PASSWORD>",
        "ORACLE_PASSWORD": "<your ORACLE_PASSWORD>",
        "GUARDRAIL_PII_MASK": "off",
        "MCP_RATE_LIMIT_RPM": "0"
      }
    }
  }
}
Environment variables
  • MCP_TRANSPORTSet to 'stdio' for desktop AI clients (Claude Desktop, Cursor). Defaults to 'http'.
  • WAREHOUSE_TYPErequiredWhich warehouse to connect to. One of: postgres, oracle, redshift, snowflake, bigquery, duckdb. (DuckDB also handles MotherDuck via DUCKDB_PATH=md:<db>.)
  • MCP_API_KEYSsecretComma-separated bearer keys with role and optional warehouse-role impersonation: 'key1:reader,key2:admin', 'key3:reader:set_role=alice'. Leave empty for stdio (OS process boundary is the trust boundary). Required for HTTP.
  • MOTHERDUCK_TOKENsecretMotherDuck service token. Required when DUCKDB_PATH starts with 'md:'.
  • PG_PASSWORDsecretPostgres password.
  • ORACLE_PASSWORDsecretOracle password.
  • GUARDRAIL_PII_MASKSet to 'on' to enable role-aware PII masking on result rows (emails, SSNs, phones, IPs, Luhn-validated CCs). Off by default.
  • MCP_RATE_LIMIT_RPMPer-principal token-bucket rate limit on tool invocations. 0 = disabled. Recommend 60 for production.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.4.2
Registry
active
Published
5/6/2026
Browse all Developer Tools →

Add the badge to your site

Show visitors that io.github.kalehdoo/warehouse-mcp is listed here — it’s also the link we check for a free listing.

io.github.kalehdoo/warehouse-mcp — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-kalehdoo-warehouse-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="io.github.kalehdoo/warehouse-mcp — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![io.github.kalehdoo/warehouse-mcp — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-kalehdoo-warehouse-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.