---
id: dbt-metabase
version: "1.7.5"
license: MIT License
license_treatment: permissive
maintenance: active
---

# dbt-metabase — dbt + Metabase integration.

License: permissive · Maintenance: active · Downloads: 128.3K/mo

## What it is and what it does

dbt-metabase is a CLI tool that bridges dbt and Metabase by reading your compiled dbt project metadata and pushing it into Metabase's data model. It propagates primary keys, foreign keys (from relationship tests or explicit meta fields), column descriptions, semantic types (email, currency, category, URL, etc.), and visibility settings from your dbt YAML into Metabase's table and column configuration. It also works in reverse: extracting Metabase questions and dashboards as dbt exposures, letting you document your BI layer alongside your data models.

The tool uses the Metabase API for all operations, requiring either an API key (recommended for automation) or username/password authentication. It handles synchronization between dbt and Metabase by default, waiting for tables and columns to appear in Metabase before attempting to export metadata. It's designed for teams using dbt as their source of truth for schema and wanting that truth reflected automatically in their Metabase analytics layer.

Use it for:

- Automatically propagate dbt model and column descriptions to Metabase without manual re-entry.
- Define foreign key relationships in dbt and have them appear as configured relationships in Metabase.
- Tag columns with semantic types (email, URL, currency) in dbt meta fields and sync them to Metabase for better field type detection.
- Extract Metabase dashboards and questions as dbt exposures to document your BI artifacts in version control.
- Hide sensitive columns in Metabase by setting visibility types in dbt YAML.
- Automate metadata synchronization in CI/CD pipelines after dbt runs.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Syncs dbt project metadata (table relationships, descriptions, semantic types) to Metabase and extracts Metabase questions and dashboards back into dbt as exposures.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and solves a real operational problem for teams using both dbt and Metabase—eliminating manual metadata duplication and keeping your analytics layer in sync with your data layer. No known vulnerabilities. Install it if you use both tools and want a single source of truth for metadata.

## Install

pip install dbt-metabase
uv add dbt-metabase
poetry add dbt-metabase

## Installing dbt-metabase

Before you install: Low install friction with a pure Python wheel and four lightweight runtime dependencies. Active maintenance with a recent release and steady development history since 2019.

License in practice: MIT License permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both commercial and open-source projects.

Quickstart:

pip install dbt-metabase

dbt-metabase models \
  --manifest-path target/manifest.json \
  --metabase-url https://metabase.example.com \
  --metabase-api-key mb_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX= \
  --metabase-database business \
  --include-schemas public

Requires Python 3.10 or above. Requires a compiled dbt manifest.json file (generated by `dbt compile`) and a running Metabase instance with API access.

Verify before relying:

- Whether the package handles all Metabase versions or has known compatibility constraints beyond the API key requirement for Metabase 49+.
- Performance characteristics when syncing large numbers of tables or columns.
- Whether custom semantic types beyond the documented list are supported.

## Package facts

- License: MIT License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 128.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dbt metabase integration, sync dbt to metabase, metabase metadata from dbt, dbt exposures from metabase, database schema documentation sync, analytics metadata propagation, dbt-integration, metadata-sync, analytics-automation

[View on SkillFed](https://skillfed.io/packages/dbt-metabase) · [View on PyPI](https://pypi.org/project/dbt-metabase/)