ClickHouse · Gemini CLI

Add the ClickHouse MCP server to Gemini CLI

Query and explore ClickHouse clusters and chDB.

Official serverLocalDatabases

1. Add the server

Run in your terminal

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

2. Sign in

Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server. ClickHouse runs locally and needs CLICKHOUSE_HOST, CLICKHOUSE_USER. Replace the placeholder values above with your own before starting Gemini CLI.

3. Try it

Ask Gemini CLI 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.

· In settings.json, streamable HTTP servers use httpUrl, SSE servers use url, local servers use command.
· includeTools and excludeTools limit which tools the model sees.

FAQ

How do I add the ClickHouse MCP server to Gemini CLI?: Run: gemini mcp add -e CLICKHOUSE_HOST=YOUR_VALUE -e CLICKHOUSE_USER=YOUR_VALUE clickhouse uvx mcp-clickhouse. Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server.
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 Gemini CLI MCP docs ClickHouse server details

ClickHouse in other clients

Claude Code Codex Cursor VS Code (GitHub Copilot)

More databases for Gemini CLI

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 Gemini CLI's documented syntax.