ClickHouse · Claude Code

Add the ClickHouse MCP server to Claude Code

Query and explore ClickHouse clusters and chDB.

Official serverLocalDatabases

1. Add the server

Run in your terminal

claude mcp add clickhouse -e CLICKHOUSE_HOST=YOUR_VALUE -e CLICKHOUSE_USER=YOUR_VALUE -- uvx mcp-clickhouse

2. Sign in

Run /mcp inside Claude Code to sign in to remote servers that use OAuth. ClickHouse runs locally and needs CLICKHOUSE_HOST, CLICKHOUSE_USER. Replace the placeholder values above with your own before starting Claude Code.

3. Try it

Ask Claude Code for something ClickHouse can do. Query and explore ClickHouse clusters and chDB. Approve the first tool call and check the result before allowing write actions automatically.

· Add --scope project to share a server with your team through .mcp.json in the repo.
· Use claude mcp list to see what is connected and claude mcp remove <name> to drop one.

FAQ

How do I add the ClickHouse MCP server to Claude Code?: Run: claude mcp add clickhouse -e CLICKHOUSE_HOST=YOUR_VALUE -e CLICKHOUSE_USER=YOUR_VALUE -- uvx mcp-clickhouse. Run /mcp inside Claude Code to sign in to remote servers that use OAuth.
Is this the official ClickHouse MCP server?: Yes. It is published by ClickHouse as io.github.ClickHouse/mcp-clickhouse in the official MCP registry.
Does the ClickHouse MCP server need an API key?: Yes. It runs locally and requires CLICKHOUSE_HOST, CLICKHOUSE_USER.

Links

ClickHouse MCP docs Claude Code MCP docs ClickHouse server details

ClickHouse in other clients

Codex Gemini CLI Cursor VS Code (GitHub Copilot)

More databases for Claude Code

Airtable Google Cloud Firestore Google Maps Mapbox MongoDB MotherDuck / DuckDB Neon PlanetScale

Work at ClickHouse?

Feature ClickHouse across the directory and its category from $49/month.

Feature this server

Reviewed Oct 5, 2026. Command generated from the registry record and checked against Claude Code's documented syntax.