---
title: "dbt MCP Server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/dbt/
description: "Connects dbt project metadata and lineage with optional local CLI, Semantic Layer and Platform operations."
---

# dbt MCP Server: review, setup & limitations · Undominated.ai

> Connects dbt project metadata and lineage with optional local CLI, Semantic Layer and Platform operations.

[← Explore all mcp servers](/mcp-servers/)

ANALYTICS ENGINEERING / dbt Labs

# dbt MCP Server

Connects dbt project metadata and lineage with optional local CLI, Semantic Layer and Platform operations.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/dbt-labs/dbt-mcp)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 7 linked sources
 Publisher dbt Labs
 Licence [Apache-2.0 ↗](https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/LICENSE)
 Revision a9db3f0826f8
 [Read what was—and wasn’t—checked ↓](#review)

“This MCP (Model Context Protocol) server provides various tools to interact with dbt.”

 [dbt Labs · upstream description ↗](https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Supports both project understanding and concrete build/test/job workflows.
- The configuration distinguishes discovery, local CLI, semantic and administrative tool groups.

### A good fit for

 - Tracing a dbt model’s lineage and test failures before changing a transformation.
- Reading a failed dbt Platform job run’s errors and artifacts through the Admin API tools.

### Weigh up before choosing

 - CLI and administrative tools can change warehouse objects or trigger/cancel jobs.
- Platform features require the relevant credentials and entitlements; project metadata access alone does not enable them.
- Platform execute_sql requires a personal access token; a service token does not enable it.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - README.md (installation, capability and permission sections)
- pyproject.toml
- src/dbt_mcp/main.py
- src/dbt_mcp/config/settings.py
- LICENSE
- Official local MCP setup: launch command, toolset requirements and authentication table
- website/docs/docs/dbt-ai/setup-local-mcp.md in dbt-labs/docs.getdbt.com at 04abff2799aa5dc4c8a26088c6c3493ada96ea5c: CLI-only client block and default toolset switches

### Our findings

 - The README explicitly warns that CLI tools may modify data models, sources and warehouse objects.
- Settings provide allow/deny lists; an unset enable list means all configured tools rather than no tools.
- The current setup guide says missing required settings automatically disable the corresponding toolsets.
- The README lists CLI tools build, clone, compile, docs, list, parse, run, show and test, and Admin API tools including trigger_job_run, retry_job_run and cancel_job_run.
- The setup guide sets DISABLE_SQL and DISABLE_DBT_CODEGEN to true by default, so execute_sql, text_to_sql and the codegen tools stay off until enabled. The CLI, Semantic Layer, Discovery and Admin API toolsets default on when their settings exist.
- The README at this commit has no client configuration block. The example shown is the setup guide’s CLI-only block, which launches uvx dbt-mcp with DBT_PROJECT_DIR and DBT_PATH; it comes from the guide’s source file in dbt-labs/docs.getdbt.com, pinned above.

### Not established by this review

 - Server startup, authentication and tool execution were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://docs.getdbt.com/docs/dbt-ai/setup-local-mcp)

DOCUMENTED COMMAND

 uvx dbt-mcp Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - Use uvx dbt-mcp in the client configuration; set DBT_PROJECT_DIR and DBT_PATH for local CLI tools, or configure the documented Platform authentication.
- Provide the local project/runtime or the relevant dbt Platform credentials according to the selected mode.

### Before you start

 - A supported Python environment and dbt project/runtime or Platform account.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "dbt": {
 "command": "uvx",
 "args": [
 "dbt-mcp"
 ],
 "env": {
 "DBT_PROJECT_DIR": "/path/to/your/dbt/project",
 "DBT_PATH": "/path/to/your/dbt/executable"
 }
 }
 }
} Copy configuration ↗

### Compatibility

An MCP client supporting stdio. · A supported Python environment and dbt project/runtime or Platform account.

### Implementation

Python

### Transports

stdio

### Analytics engineering / Configured credentials or local access

 - Reads model definitions, lineage and metrics; enabled CLI/API tools can build models, execute queries and manage job runs.
- Authenticates to dbt Platform with OAuth or DBT_TOKEN (a personal access token or service token). The local CLI tools run the dbt executable named by DBT_PATH against DBT_PROJECT_DIR.

### Cost model

dbt Platform entitlements, warehouse queries and local execution determine cost.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Official documentation ↗](https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/README.md) Checked 2026-10-13 https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/README.md Supports: summary, whySelected, bestFor, limitations, install, access, compatibility, transports, review
- [Applicable source licence ↗](https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/LICENSE) Checked 2026-10-13 https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/LICENSE Supports: license
- [Implementation: pyproject.toml ↗](https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/pyproject.toml) Checked 2026-10-13 https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/pyproject.toml Supports: language, review
- [Implementation: src/dbt_mcp/main.py ↗](https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/src/dbt_mcp/main.py) Checked 2026-10-13 https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/src/dbt_mcp/main.py Supports: language, review
- [Implementation: src/dbt_mcp/config/settings.py ↗](https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/src/dbt_mcp/config/settings.py) Checked 2026-10-13 https://github.com/dbt-labs/dbt-mcp/blob/a9db3f0826f8cf2ed12fe787ef65d3204c57f251/src/dbt_mcp/config/settings.py Supports: language, review
- [dbt local MCP setup ↗](https://docs.getdbt.com/docs/dbt-ai/setup-local-mcp) Checked 2026-10-13 https://docs.getdbt.com/docs/dbt-ai/setup-local-mcp Supports: install, limitations, access, review
- [dbt local MCP setup guide source (docs.getdbt.com repository) ↗](https://github.com/dbt-labs/docs.getdbt.com/blob/04abff2799aa5dc4c8a26088c6c3493ada96ea5c/website/docs/docs/dbt-ai/setup-local-mcp.md) Checked 2026-10-13 https://github.com/dbt-labs/docs.getdbt.com/blob/04abff2799aa5dc4c8a26088c6c3493ada96ea5c/website/docs/docs/dbt-ai/setup-local-mcp.md Supports: configExample, review, Default toolset switches, execute_sql requires a personal access token

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### AWS IaC MCP Server ↗ Validates CloudFormation templates, retrieves CDK/CloudFormation guidance and investigates failed deployments.](/mcp-servers/aws-iac/)[### AWS Labs OpenAPI MCP ↗ Pins the OpenAPI MCP server that builds tools from an operator-supplied spec and names stdio as the transport.](/mcp-servers/awslabs-openapi/)[### Chroma MCP ↗ Lets an assistant create and query Chroma collections through local, HTTP or Chroma Cloud database connections.](/mcp-servers/chroma/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
