clickhouse-mcp-server MCP Server

A Model Context Protocol (MCP) server implementation that enables Claude AI to interact with ClickHouse databases through a secure and efficient interface.

Local serverstdioMIT

What is the clickhouse-mcp-server MCP Server?

clickhouse-mcp-server is an MCP project maintained in the harshithgowdakt/clickhouse-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server implementation that enables Claude AI to interact with ClickHouse databases through a secure and efficient interface”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares CLICKHOUSE_HOST, CLICKHOUSE_PORT, CLICKHOUSE_USER, CLICKHOUSE_PASSWORD, CLICKHOUSE_SECURE, CLICKHOUSE_VERIFY, CLICKHOUSE_CONNECT_TIMEOUT, CLICKHOUSE_SEND_RECEIVE_TIMEOUT. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the clickhouse-mcp-server MCP Server

{
  "mcpServers": {
    "clickhouse": {
      "command": "node",
      "args": [
        "/path/to/your/clickhouse-mcp-server/dist/index.js"
      ],
      "env": {
        "CLICKHOUSE_HOST": "<clickhouse-host>",
        "CLICKHOUSE_PORT": "<clickhouse-port>",
        "CLICKHOUSE_USER": "<clickhouse-user>",
        "CLICKHOUSE_PASSWORD": "YOUR_CLICKHOUSE_PASSWORD",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
CLICKHOUSE_HOSTDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_PORTDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_USERDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_PASSWORDDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_SECUREDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_VERIFYDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_CONNECT_TIMEOUTDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_SEND_RECEIVE_TIMEOUTDeclared in the maintainer’s client configuration.Check documentation