mcpbeat

ClickHouse MCP Server

io.github.ClickHouse/mcp-clickhouse
local only

ClickHouse runs on your own machine — the client starts it, so there is no endpoint to ping. 47 291 installs a week from pypi. Last commit 23 Jul 2026.

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

Installs per day peak 10 288 · avg 5 285 · +39% w/w
a month agotoday
47 291
Installs / week
pypi · mcp-clickhouse
840
Stars
24 open issues
23 Jul 2026
Last commit
0 releases in 90 days
Apache-2.0
License
Python

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mcp-clickhouse -- uvx mcp-clickhouse
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-clickhouse": {
      "args": [
        "mcp-clickhouse"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp-clickhouse]
command = "uvx"
args = ["mcp-clickhouse"]
.cursor/mcp.json
{
  "mcpServers": {
    "mcp-clickhouse": {
      "args": [
        "mcp-clickhouse"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mcp-clickhouse": {
      "args": [
        "mcp-clickhouse"
      ],
      "command": "uvx"
    }
  }
}

ClickHouse — questions

Answers built from our own checks of this server.

Why is there no uptime for ClickHouse?
ClickHouse runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package mcp-clickhouse was installed 47 291 times last week.
How do I connect ClickHouse?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls mcp-clickhouse straight from pypi; nothing to host, nothing to sign up for.
How many people use ClickHouse?
The pypi package mcp-clickhouse was installed 47 291 times in the last week. Week over week that is +39%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is ClickHouse open source?
Yes — it is published under the Apache-2.0 licence, written in Python, 840 stars on GitHub and 24 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.