> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Connect ClickHouse Cloud to a Notion Custom Agent via the ClickHouse Remote MCP server.

# Connecting Notion to ClickHouse

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            Partner Integration
        </div>;
};

export const Image = ({img, alt, size = "lg", background}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} style={{
    backgroundColor
  }} />
      </Frame>
    </div>;
};

<PartnerBadge />

[Notion](https://www.notion.com/) is a connected workspace for notes, docs, projects, and AI-powered Custom Agents.

You can connect ClickHouse Cloud to a Notion [Custom Agent](https://www.notion.com/help/mcp-connections-for-custom-agents). Once connected, the agent can explore your data, run read-only analytical queries, and surface service and cost information from ClickHouse Cloud without leaving Notion.

<h2 id="prerequisites">
  Prerequisites
</h2>

* A running [ClickHouse Cloud service](/docs/get-started/setup/cloud) with the [Remote MCP server enabled](/docs/products/cloud/features/ai-ml/mcp/remote-mcp#enable-remote-mcp-server)
* A Notion workspace on the **Business** or **Enterprise** plan

<h2 id="connect-clickhouse-to-notion">
  Connect ClickHouse to a Notion custom agent
</h2>

ClickHouse ships as a preconfigured connection in Notion (currently in beta). No custom MCP server setup or URL pasting is required.

1. In Notion, create a new Custom Agent from the **Agents** section in the sidebar.
2. In your Agent's **Settings**, under **Tools and Access**, select **Add connection** and add **ClickHouse** from the list of available connections.

<Image img="https://mintcdn.com/private-7c7dfe99/6s0zAeps_NYZmK2e/images/integrations/tools/data-integration/notion/add-clickhouse-connection.webp?fit=max&auto=format&n=6s0zAeps_NYZmK2e&q=85&s=f1b99ea1e9b17614fecbcf1218a3c48b" size="md" alt="Selecting ClickHouse in the Notion Add connection picker" width="3008" height="1720" data-path="images/integrations/tools/data-integration/notion/add-clickhouse-connection.webp" />

3. Click **Connect** and complete the OAuth flow using your ClickHouse Cloud credentials. Access is scoped to the organizations and services your account can already reach.

4. Expand the new ClickHouse connection in the agent's settings and toggle on the tools you want this agent to use. For each tool you can also choose whether the agent should run it automatically or always ask for approval. All tools exposed by the ClickHouse Remote MCP server are read-only. See the [available tools](/docs/products/cloud/features/ai-ml/remote-mcp#available-tools) reference for the full, up-to-date list.

<Image img="https://mintcdn.com/private-7c7dfe99/6s0zAeps_NYZmK2e/images/integrations/tools/data-integration/notion/clickhouse-tools-toggles.webp?fit=max&auto=format&n=6s0zAeps_NYZmK2e&q=85&s=c391382f3db26ddd1d0095a932f63491" size="md" alt="The expanded ClickHouse connection in Notion showing the per-tool toggles" width="3008" height="1720" data-path="images/integrations/tools/data-integration/notion/clickhouse-tools-toggles.webp" />

<Note>
  Each Custom Agent requires its own ClickHouse connection, and only the person who authenticated a connection can change its tool settings. See Notion's [security best practices for Agent connections](https://www.notion.com/help/security-best-practices-for-agent-connections) for more details.
</Note>

<h2 id="related-content">
  Related content
</h2>

* [Enable and connect ClickHouse Cloud remote MCP server](/docs/products/cloud/features/ai-ml/mcp/remote-mcp)
* [Remote MCP in Cloud: tool reference](/docs/products/cloud/features/ai-ml/remote-mcp)
* Notion: [MCP connections for Custom Agents](https://www.notion.com/help/mcp-connections-for-custom-agents)
* Notion: [Connect Custom Agents to your tool stack with MCP integrations](https://www.notion.com/help/guides/connect-custom-agents-to-mcp-integrations)