ClickHouse MCP Server

A Model Context Protocol (MCP) server that connects to ClickHouse databases and allows LLMs like Claude to explore and analyze data through natural language queries.

Local serverstdioMIT

What is the ClickHouse MCP Server?

ClickHouse MCP Server is an MCP project maintained in the bjpadhy/clickhouse-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that connects to ClickHouse databases and allows LLMs like Claude to explore and analyze data through natural language queries”. 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_URL, CLICKHOUSE_USERNAME, CLICKHOUSE_PASSWORD, CLICKHOUSE_DATABASE. 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.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
execute-sqlRun a read-only SQL query against the database
natural-language-queryAsk questions about your data in natural language

How to install the ClickHouse MCP Server

{
  "mcpServers": {
    "clickhouse-analytics": {
      "command": "node",
      "args": [
        "/absolute/path/to/clickhouse-mcp-server/dist/index.js"
      ],
      "env": {
        "CLICKHOUSE_URL": "your_clickhouse_url",
        "CLICKHOUSE_USERNAME": "your_username",
        "CLICKHOUSE_PASSWORD": "YOUR_CLICKHOUSE_PASSWORD",
        "CLICKHOUSE_DATABASE": "your_database"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
CLICKHOUSE_URLDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_PASSWORDDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_DATABASEDeclared in the maintainer’s client configuration.Check documentation