---
title: Connect Metabase to Tinybird
meta:
  description: This guide covers the steps to connect Metabase to Tinybird using the ClickHouse® database driver, enabling business intelligence and data visualization.
headingMaxLevels: 2
---

# Connect Metabase to Tinybird

You can connect to Tinybird from Metabase using the ClickHouse® database driver, taking advantage of Tinybird's ClickHouse® HTTP protocol compatibility. Create dashboards, explore data, and build business intelligence reports with your Tinybird data.

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

{% callout type="caution" %}
Tinybird does not support Metabase's Roles or Impersonation features. You can access the data but the permissions are handled by the Tinybird Token used to configure the connection.
{% /callout %}

## Prerequisites

- 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](/classic/work-with-data/publish-data/clickhouse-interface#auth-token-requirements).
- ClickHouse® driver installed in Metabase (available by default in recent versions)

## Add Tinybird as a database

1. **Access Admin Panel**: In Metabase, select the **gear icon** and select **Admin settings**
2. **Navigate to Databases**: Select **Databases** in the navigation menu
3. **Add a database**: Select **Add database** button
4. **Select ClickHouse®**: Choose **ClickHouse®** from the database type dropdown

### Database configuration

Configure the connection with these settings:

```bash
Display name: Tinybird Production  # Choose a descriptive name
Host: {% user("clickhouseHost") %}
Port: 443  # Use 443 for HTTPS
Databases: <WORKSPACE_NAME> tinybird organization  # Your Workspace name and Service Data Sources
```

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

### Authentication

```bash
Username: <WORKSPACE_NAME>  # not used for auth, helps you identify the connection
Password: <TOKEN>  # Your Tinybird Auth Token
```

### Advanced options

```bash
Use a secure connection (SSL): enabled
```

5. **Save the database**: Select **Save** to add the database to Metabase

{% image src="/img/metabase-clickhouse-connection.png" alt="Metabase ClickHouse® connection configuration" caption="Metabase ClickHouse® connection configuration" /%}

## Test the connection

Once configured, test your connection by creating a simple query:

1. Select **+ New** to create new SQL query
2. Select your newly created database
3. Write a simple query to test the connection

If the connection is working, you should see the result.

## Learn more

- [ClickHouse® Interface overview](/classic/work-with-data/publish-data/clickhouse-interface)
- [Tinybird Auth Token management](/classic/administration/auth-tokens)