Connect ClickHouse MCP to your AI Agents

Real-time analytics on ClickHouse at any scale, in plain English.

Example prompts

Everything you can ask your agent about your ClickHouse data.

Ask in plain English — Sequel translates it into a ClickHouse query, runs it, and your agent hands back the answer. No SQL, no dashboards, no CSV exports.

Connect to your agent
What you can ask your agent
  • How many events did we receive per hour yesterday?
  • What's the funnel conversion rate from signup to first purchase?
  • Show me the top 10 users by event count this week
  • Which event types have increased most in the last 7 days?
  • What's the day-1 retention rate for users who signed up last month?

Install

Install ClickHouse MCP in your agent

Pick your app and Sequel installs itself: a one-click link where the client supports it, that client’s own few steps where it doesn’t. Every route signs in with your Sequel account over OAuth, so there is no API key to copy and nothing to keep in sync.

Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex, Grok, Muse, dots and any other MCP app

Already have an MCP client?

https://api.sequel.sh/mcp

Add it as a remote (streamable HTTP) server and sign in when prompted. Skills come with it; nothing else to install. Manual setup per client

Choose your app

  • Claude

    One click, opens in the app

  • Cursor

    One click, opens in the app

  • VS Code

    One click, opens in the app

  • ChatGPT

    Turn on developer mode, then add Sequel. About two minutes.

  • Claude Code

    Run one command, then sign in with /mcp.

  • Codex

    Run one command, then sign in.

  • Gemini CLI

    Run one command, then sign in with /mcp auth.

  • Grok

    Add Sequel as a connector and sign in.

  • Grok Bot

    Paste this to the bot. It registers Sequel and asks you to sign in.

  • Muse

    Muse writes its own connector. One message is the whole setup.

  • dots

    Add Sequel in ChatGPT; your dot picks it up with no extra step.

  • OpenCode

    Add Sequel as a remote server from the OpenCode CLI.

  • Other MCP app

    Any client that speaks remote MCP can connect with this URL.

Frequently asked questions

How do I connect ClickHouse?

Click 'New Connection', select ClickHouse, and enter your host, port, database, username, and password. Sequel supports both HTTP and native interfaces.

Which ClickHouse versions are supported?

Sequel supports ClickHouse 21.x and above, including ClickHouse Cloud.

Can Sequel handle large ClickHouse tables?

Yes. Sequel adds LIMIT clauses by default and warns you before running queries that may trigger full table scans on large datasets. ClickHouse's columnar storage makes even large queries fast.

Does Sequel use ClickHouse-specific SQL features?

Yes. Sequel generates ClickHouse-compatible SQL including toStartOfHour, toDate, arrayJoin, and other ClickHouse functions when appropriate.

Can I connect ClickHouse Cloud?

Yes. Enter your ClickHouse Cloud hostname, port 8443, and credentials. Make sure to allowlist Sequel's IP in your ClickHouse Cloud instance settings.

Is my ClickHouse connection read-only?

Yes. Sequel is read-only by default and will not execute write operations unless you explicitly request them.

Start analyzing your ClickHouse data today

Connect in minutes — then ask across all your data, not just one source.