ClickHouse Cloud MCP Server

This MCP server provides tools to interact with the ClickHouse Cloud API (v1). It allows managing organizations and services, the rest is TODO.

Local serverstdioMIT

What is the ClickHouse Cloud MCP Server?

ClickHouse Cloud MCP Server is an MCP project maintained in the alexkorep/mcp-server-clickhouse repository. The maintainer describes its purpose as “This MCP server provides tools to interact with the ClickHouse Cloud API (v1). It allows managing organizations and services, the rest is TODO”. 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_API_KEY_ID, CLICKHOUSE_API_SECRET, CLICKHOUSE_API_URL. 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 Cloud MCP Server

{
  "mcpServers": {
    "clickhouse": {
      "command": "node",
      "args": [
        "/full/path/to/dist/index.js"
      ],
      "env": {
        "CLICKHOUSE_API_KEY_ID": "YOUR_CLICKHOUSE_API_KEY_ID",
        "CLICKHOUSE_API_SECRET": "YOUR_CLICKHOUSE_API_SECRET",
        "CLICKHOUSE_API_URL": "http://localhost:2023"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
CLICKHOUSE_API_KEY_IDDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_API_SECRETDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_API_URLDeclared in the maintainer’s client configuration.Check documentation