CuratedMCP
Claude Desktop
PyPI

How to install ClickHouse in Claude Desktop

Official ClickHouse MCP server for querying and exploring ClickHouse clusters and chDB.

Indexed, not yet reviewed

We found ClickHouse in the official MCP registry. Our automated check passed on Nov 1, 2026 (it confirms the server is published and reachable), but no one at CuratedMCP has reviewed its code, permissions or credentials handling. Check what it can access before you give it keys. Scan your machine free to see every MCP server you have installed.

Steps

  1. 1Install uv (for uvx): https://docs.astral.sh/uv/
  2. 2In Claude Desktop open Settings → Developer → Edit Config
  3. 3Add the entry below. If the file already has "mcpServers", add just the inner entry
  4. 4Quit and reopen Claude Desktop

Configuration

claude_desktop_config.json
{
  "mcpServers": {
    "clickhouse": {
      "command": "uvx",
      "args": [
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "<clickhouse-host>",
        "CLICKHOUSE_USER": "<clickhouse-user>"
      }
    }
  }
}

Replace the values in angle brackets. Optional settings are listed below.

Environment variableRequiredWhat it is
CLICKHOUSE_HOSTYesHostname of the ClickHouse server
CLICKHOUSE_USERYesUsername for ClickHouse authentication
CLICKHOUSE_PASSWORDsecretNoPassword for ClickHouse authentication. Required unless a client certificate uses the default or mutual TLS mode
CLICKHOUSE_PORTNoClickHouse HTTP(S) port. Defaults to 8443 when CLICKHOUSE_SECURE=true, 8123 otherwise
CLICKHOUSE_SECURENoUse HTTPS to connect to ClickHouse
CLICKHOUSE_VERIFYNoVerify SSL certificates
CLICKHOUSE_CA_CERTNoPath to a PEM CA bundle for ClickHouse server certificate verification
CLICKHOUSE_CLIENT_CERTNoPath to a PEM client certificate for the ClickHouse HTTPS connection
CLICKHOUSE_CLIENT_CERT_KEYNoPath to the PEM private key for CLICKHOUSE_CLIENT_CERT
CLICKHOUSE_TLS_MODENoClient certificate mode: mutual, proxy, or strict
CLICKHOUSE_DATABASENoDefault database to use
CLICKHOUSE_ROLENoClickHouse role to activate for the session
CLICKHOUSE_ALLOW_WRITE_ACCESSNoAllow write operations (DDL and DML). Queries run read-only by default
CLICKHOUSE_ALLOW_DROPNoAllow destructive operations (DROP, TRUNCATE, DELETE, UPDATE, REPLACE, CLEAR, and DETACH PERMANENTLY) when write access is also enabled
CLICKHOUSE_MCP_QUERY_TIMEOUTNoQuery tool timeout in seconds
CLICKHOUSE_MCP_MAX_WORKERSNoMaximum query worker thread pool size

Install in other clients

About ClickHouse: repo, license and check results →

Maintain ClickHouse?

Claim this page to get a full CuratedMCP listing: edit your description, see listing analytics, and add our README badge. Listing is free, and a person checks every submission before it goes live. We'll pre-fill the form from the registry.

    How to install ClickHouse MCP server in Claude Desktop | CuratedMCP