Set up the ClickHouse documentation MCP server

This page configures the MCP server for searching the ClickHouse documentation. To query ClickHouse data instead, use the open-source ClickHouse MCP server or the ClickHouse Cloud remote MCP server.

Query the ClickHouse documentation directly from your AI tools using the Model Context Protocol (MCP).

Connect your AI tool

Claude Code
Claude Desktop
Codex
Cursor
Windsurf

Run in your terminal:

claude mcp add --transport http clickhouse-docs https://clickhouse.com/docs/mcp --scope user

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "clickhouse-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://clickhouse.com/docs/mcp"]
    }
  }
}

Run in your terminal:

codex mcp add clickhouse-docs --url https://clickhouse.com/docs/mcp

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "clickhouse-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://clickhouse.com/docs/mcp"]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "clickhouse-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://clickhouse.com/docs/mcp"]
    }
  }
}

Add ClickHouse skills to your coding agent

Install the ClickHouse skills to give your agent expert ClickHouse knowledge and best practices:

npx skills add https://clickhouse.com

Last modified on August 20, 2026

​Connect your AI tool

​Add ClickHouse skills to your coding agent

Connect your AI tool

Add ClickHouse skills to your coding agent