How to integrate ClickHouse MCP with Antigravity

Trusted by
AWS
Glean
Zoom
Airtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

ClickHouse logo
Antigravity logo
divider

How to integrate ClickHouse MCP with Antigravity

Antigravity IDE is Google's agentic IDE, built on a VS Code-style editor and powered by models like Gemini 3.5 Flash, Gemini 3.1 Pro, Opus 4.6, and more. It treats the AI agent as a first-class teammate, planning, coding, and validating work through an Agent Manager dashboard with deep browser connectivity.

In this guide, I will explain the easiest and most secure way to connect your ClickHouse account to Antigravity IDE via Composio Connect, so it can show total user signups for last week, summarize top 5 products by revenue, insert a new sales record into database, and more without ever putting your account credentials at risk.

Also integrate ClickHouse with

Why use Composio?

Composio provides:

  • Access to 1,000+ managed apps from a single MCP endpoint. This makes it convenient for agents to run cross-app workflows.
  • Programmatic tool calling. Allows LLMs to write code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool response handling outside the LLM context. This minimizes context bloat from large tool responses.
  • Dynamic just-in-time access to thousands of tools across hundreds of apps. Composio loads the tools your agent needs, so LLMs are not overwhelmed by tools they do not need.

Connect ClickHouse to Antigravity

Antigravity does not ship with one-click custom MCP install links yet, so configuration goes through the IDE's raw config file. The process takes under a minute.

1. Open the MCP Config

Go to Antigravity Settings, open the Customizations tab, then click Open MCP Config to open mcp_config.json in the editor.

Antigravity Customizations settings with Open MCP Config button

2. Get your API key

Go to the Composio Dashboard and copy your API key.

Composio Dashboard showing where to get the API key

3. Add Composio to mcp_config.json

Paste the following configuration into the file:

bash
{
  "mcpServers": {
    "remote-composio": {
      "serverUrl": "https://connect.composio.dev/mcp",
      "headers": {
        "x-consumer-api-key": "your-composio-api-key"
      }
    }
  }
}

Note: Antigravity uses serverUrl, not url, for remote HTTP-based MCP servers. This differs from the url key used in Cursor and VS Code configs.

Save the file and click refresh in the Installed MCP Servers section.

Antigravity showing Composio tools after MCP setup

Connect your ClickHouse account

Back in the Antigravity agent panel, ask the agent to connect to ClickHouse or give it any ClickHouse-related task.

For example, ask it to:

  • "Show total user signups for last week"
  • "Summarize top 5 products by revenue"
  • "Insert a new sales record into database"

It will prompt you to authenticate and authorize access to ClickHouse.

That is it. Composio tools are now available in Antigravity, and your ClickHouse account is ready to use.

Supported Tools & Triggers

Tools
Execute ClickHouse QueryExecute a SQL query in ClickHouse and return the results.
Get Database SchemaGet comprehensive schema overview of an entire database including all tables and optionally their column definitions.
Get ClickHouse Play InterfaceGet the ClickHouse Play web user interface for interactive query execution.
Get Table SchemaGet detailed schema information for a specific table including column definitions, types, keys, and optionally sample data.
List ClickHouse DatabasesList all databases in the ClickHouse instance.
List ClickHouse TablesList tables in ClickHouse databases.

Conclusion

You have successfully connected ClickHouse to Antigravity using Composio Connect. Your agent can now use ClickHouse securely without exposing credentials in prompts or local scripts.

How to build ClickHouse MCP Agent with another framework

ChatGPT logo

ChatGPT

Use ClickHouse MCP with ChatGPT

OpenAI Agents SDK logo

OpenAI Agents SDK

Use ClickHouse MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use ClickHouse MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use ClickHouse MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use ClickHouse MCP with Claude Cowork

Codex logo

Codex

Use ClickHouse MCP with Codex

Cursor logo

Cursor

Use ClickHouse MCP with Cursor

OpenClaw logo

OpenClaw

Use ClickHouse MCP with OpenClaw

Hermes logo

Hermes

Use ClickHouse MCP with Hermes

CLI logo

CLI

Use ClickHouse MCP with CLI

Google ADK logo

Google ADK

Use ClickHouse MCP with Google ADK

LangChain logo

LangChain

Use ClickHouse MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use ClickHouse MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use ClickHouse MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use ClickHouse MCP with LlamaIndex

CrewAI logo

CrewAI

Use ClickHouse MCP with CrewAI

OpenCode logo

OpenCode

Use ClickHouse MCP with OpenCode

VS Code logo

VS Code

Use ClickHouse MCP with VS Code

FAQ

What are the differences in Tool Router MCP and ClickHouse MCP?

With a standalone ClickHouse MCP server, the agents and LLMs can only access a fixed set of ClickHouse tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from ClickHouse and many other apps based on the task at hand, all through a single MCP endpoint.

Can I use Tool Router MCP with Antigravity?

Yes, you can. Antigravity fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right ClickHouse tools.

Can I manage the permissions and scopes for ClickHouse while using Tool Router?

Yes, absolutely. You can configure which ClickHouse scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your ClickHouse data and credentials are handled as safely as possible.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗