---
title: Connect Deepnote to Tinybird
meta:
  description: This guide covers the steps to connect Deepnote to Tinybird using the ClickHouse HTTP interface.
headingMaxLevels: 2
---

# Connect Deepnote to Tinybird

Deepnote can connect to Tinybird using the ClickHouse® Data Source, taking advantage of Tinybird's ClickHouse® HTTP protocol compatibility.

{% callout type="info" %}
The ClickHouse® connection to Tinybird is read-only. You can use it to query and analyze data from your Tinybird data sources, but you cannot modify data through this connection.
{% /callout %}

## Prerequisites

- A [Deepnote](https://deepnote.com) account
- A Tinybird workspace with data sources
- A Tinybird Auth Token with scopes `WORKSPACE:READ_ALL` and optionally `ORG_DATASOURCES:READ`. See [how to create it](../clickhouse-interface#auth-token-requirements).

## Create a new connection

1. Select **Integrations > Add integration**.
2. In the **Create new integration** view, select **ClickHouse®** from the Data warehouses & lakes list.
3. Fill in the ClickHouse database credentials.

### Connection settings

```bash
Integration name: Tinybird
Host name: {% user("clickhouseHost") %}
Port: 443  # For HTTPS connections
Database: <WORKSPACE_NAME>  # Your workspace name
Username: <WORKSPACE_NAME>  # Your workspace name
Password: {% user("JWT") %}  # Your Tinybird auth token
Enforce SSL encryption: yes
```

{% callout type="info" %}
See the list of [ClickHouse hosts](../clickhouse-interface#clickhouse-interface-hosts) to find the correct one for your region.
{% /callout %}

## Learn more

- [ClickHouse Interface overview](../clickhouse-interface)
- [Tinybird Auth Token management](/classic/administration/auth-tokens)