dbt-mcp

library1.20.4pypypiunverified

A MCP (Model Context Protocol) server for interacting with dbt resources. Current version: 1.16.0. Released 2026-04-27. Follows semantic versioning with frequent releases (biweekly).

workflow data devops

pip install dbt-mcp

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · DBT-MCP

dbt-mcp

workflowpythonv1.20.4

Install

12.9s avg

Import

—

Disk

295MB

Pass rate

2/ 10

Env Coverage2 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.20.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

py 3.11

✕ build_error

py 3.12

✕ build_error

✓ 13s

py 3.13

✕ build_error

✓ 12.9s

py 3.9

✕ build_error

295MB installed

● package 295MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

MCPServer

✓ from dbt_mcp import MCPServer

✗ from dbt_mcp.server import MCPServer

Start a basic dbt MCP server. Requires dbt Cloud account ID and token set in environment.

import os from dbt_mcp.server import MCPServer server = MCPServer() server.run()

Debug

Known issues

breakingIn v1.15.0, the `get_job_run_artifact` tool was removed. If you rely on it, pin to <1.15.0 or migrate to alternative tooling.

fix

Use `list_artifacts` and `get_artifact` (if available) or custom API calls.

affects: >=1.15.0

breakingIn v1.13.0, `get_project_details` tool was removed. Multi-project config now uses Admin API Client.

fix

Migrate to multi-project server config with `config_override` or use `list_projects`.

affects: >=1.13.0

deprecatedThe `DBT_LSP_PATH` environment variable is deprecated in favor of built-in Fusion LSP support. Will be removed in future version.

fix

Remove `DBT_LSP_PATH`; use default Fusion LSP or editor storage paths.

affects: >=1.16.0

gotchaPython 3.12+ required. The server will fail to start on Python <3.12.

fix

Ensure Python 3.12 or later.

affects: >=1.15.0

gotchaIf the `mcp.lock` file is a symbolic link, creation of FileLock may raise OSError on some systems. Fixed in v1.15.0 by resolving symlinks before locking.

fix

Upgrade to >=1.15.0 or avoid symlinked paths for `~/.dbt/mcp.lock`.

affects: <1.15.0

gotcha`list_metrics` response format changed from JSON to CSV in v1.15.1 to reduce payload size. Parsing code expecting JSON will break.

fix

Update metric parsing to handle CSV (or update to use new threshold `DBT_MCP_SL_FULL_CONFIG_THRESHOLD`).

affects: >=1.15.1

Upgrade

Version history

1.20.4latest on PyPI · released Jun 15, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

34 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/dbt-labs/dbt-mcp ↗

packagehttps://pypi.org/project/dbt-mcp/ ↗

docshttps://docs.getdbt.com/docs/dbt-ai/about-mcp ↗

changeloghttps://github.com/dbt-labs/dbt-mcp/blob/main/CHANGELOG.md ↗