> **Building with AI coding agents?** If you're using an AI coding agent, install the official Scalekit plugin. It gives your agent full awareness of the Scalekit API — reducing hallucinations and enabling faster, more accurate code generation.
>
> - **Claude Code**: `claude plugin marketplace add scalekit-inc/claude-code-authstack && claude plugin install <auth-type>@scalekit-auth-stack`
> - **GitHub Copilot CLI**: `copilot plugin marketplace add scalekit-inc/github-copilot-authstack` then `copilot plugin install <auth-type>@scalekit-auth-stack`
> - **Codex**: run the bash installer, restart, then open Plugin Directory and enable `<auth-type>`
> - **Skills CLI** (Windsurf, Cline, 40+ agents): `npx skills add scalekit-inc/skills --list` then `--skill <skill-name>`
>
> `<auth-type>` / `<skill-name>`: `agentkit`, `full-stack-auth`, `mcp-auth`, `modular-sso`, `modular-scim` — [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# ClickHouse connector

1. ### Install the SDK

   ```bash frame="terminal"
       npm install @scalekit-sdk/node
       ```
     ```bash frame="terminal"
       pip install scalekit
       ```
     Full SDK reference: [Node.js](/agentkit/sdks/node/) | [Python](/agentkit/sdks/python/)

2. ### Set your credentials

   <AgentKitCredentials />

3. ### Authorize and make your first call

   <QuickstartGenericOauthSection connector="clickhouse" toolName="clickhouse_get_organizations" providerName="ClickHouse" />

## What you can do

Connect this agent connector to let your agent:

- **Run SELECT queries** — execute read-only SQL queries against any ClickHouse service and retrieve results directly in your agent
- **Explore schema** — list databases, tables, and column types to understand your data model before writing queries
- **Manage services** — list, inspect, and get full details for ClickHouse Cloud services (clusters) in an organization
- **Monitor backups** — list service backups, get backup details, and retrieve the backup schedule and retention config
- **Inspect ClickPipes** — list and retrieve data ingestion pipeline status and configuration
- **Track costs** — get billing and usage cost data for an organization over a custom date range

## Common workflows

<SectionAfterSetupClickhouseCommonWorkflows />

## Tool list

Use the exact tool names from the **Tool list** below when you call `execute_tool`. If you're not sure which name to use, list the tools available for the current user first.

<ToolList tools={tools} />

---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |