Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Databases - official ClickHouse server

ClickHouse Cloud remote MCP server

A fully managed remote MCP endpoint for ClickHouse Cloud services that lets agents list databases and tables, run read-only SELECT queries, and inspect organizations, services, backups, ClickPipes and billing. All 13 tools are read-only. ClickHouse hosts it at https://mcp.clickhouse.cloud/mcp with OAuth or API key auth.

Last verified 13 tools3 sources

Install

Terminal
claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp
Terminal
codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp

VS Code

JSON
{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

Generic

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

Tools

run_select_query
Execute a read-only SELECT query against a ClickHouse service.
list_databases
List all databases available in a ClickHouse service.
list_tables
List all tables in a database, including column definitions.
get_organizations
Retrieve all ClickHouse Cloud organizations accessible to the user.
get_organization_details
Return details of a single organization.
get_services_list
List all services in a ClickHouse Cloud organization.
get_service_details
Return details of a specific service.
list_service_backups
List all backups for a service, most recent first.
get_service_backup_details
Return details of a single backup.
get_service_backup_configuration
Return the backup schedule and retention settings for a service.
list_clickpipes
List all ClickPipes configured for a service.
get_clickpipe
Return details of a specific ClickPipe.
get_organization_cost
Retrieve billing and usage cost data for an organization (max 31-day range).

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Works only with ClickHouse Cloud services.
  • It must be turned on per service in the Cloud console (Connect > MCP), which requires the control-plane:service:manage-mcp permission.
  • Auth is OAuth 2.0 with Cloud credentials, or a Cloud API key sent as HTTP Basic auth for headless use.
  • Status beta comes from ClickHouse's public beta launch blog; the current docs carry no status label.
  • The generic snippet is the one the docs give for Windsurf (via mcp-remote).
  • For Cursor, the docs only say to install it from the Cursor Marketplace.

FAQ

What does the ClickHouse Cloud remote MCP server do?

A fully managed remote MCP endpoint for ClickHouse Cloud services that lets agents list databases and tables, run read-only SELECT queries, and inspect organizations, services, backups, ClickPipes and billing. All 13 tools are read-only. The vendor documents 13 tools, including run_select_query, list_databases, list_tables and get_organizations.

How do I add the ClickHouse Cloud remote MCP server to Claude Code?

Run claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp, copied from ClickHouse's docs. This page also has snippets for Codex, VS Code and Generic.

Does the ClickHouse Cloud remote MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP. Status: Beta, last checked October 17, 2026.

Sources

Last verified against 3 ClickHouse pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.