---
id: dbt-mcp
version: "1.22.1"
license: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# dbt-mcp — A MCP (Model Context Protocol) server for interacting with dbt resources.

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

## What it is and what it does

dbt-mcp is a Model Context Protocol server that bridges dbt projects and AI agents. It wraps dbt's discovery, semantic layer, admin, and CLI capabilities into standardized MCP tools that agents can call to understand project structure, execute queries, and trigger jobs. The server runs as a FastAPI application via uvicorn and exposes tools for SQL execution, metric queries, lineage traversal, model discovery, job management, and documentation search—all without requiring the agent to understand dbt's native APIs.

You install and run it to connect AI agents to your dbt environment. The server handles authentication via authlib and JWT, manages state with filelock, and communicates with dbt Platform or local dbt projects depending on which tools you invoke. It's designed for teams that want agents to reason about data models, suggest transformations, or automate dbt operations within a larger AI workflow.

Use it for:

- Connect an AI agent to your dbt project so it can understand model lineage and suggest data transformations
- Enable an agent to execute metric queries and generate SQL from natural language descriptions of your data
- Automate dbt job triggering and monitoring through an agent interface without manual API calls
- Let an agent search dbt documentation and project resources to answer questions about your data architecture
- Generate boilerplate dbt YAML and SQL via an agent using codegen tools without manual scaffolding

## Worth the install?

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

Exposes dbt project metadata and operations through a Model Context Protocol server, enabling AI agents to query models, metrics, lineage, and execute dbt commands via standardized tools.

Yes, if you are building or using AI agents that need to interact with dbt projects. The package is actively maintained, has low install friction, carries a permissive license, and exposes a comprehensive set of dbt operations through a standardized protocol. Start with a test integration to verify the tools you need are available and that your authentication setup works with your dbt environment.

## Install

pip install dbt-mcp
uv add dbt-mcp
poetry add dbt-mcp

## Installing dbt-mcp

Before you install: Low friction installation with a pure-Python wheel. Maintained actively with recent releases; last commit 2026-08-14 and 596 repository stars indicate ongoing development. Dependencies are pinned to specific versions with security-only updates.

License in practice: Apache License 2.0 is permissive; you may use, modify, and distribute this package freely provided you retain license notices and include a copy of the license with any derivative works.

Quickstart:

pip install dbt-mcp

# Start the MCP server (requires dbt credentials and configuration)
python -m dbt_mcp.server

# In your MCP client, connect to the server and call tools like:
# { "name": "list_metrics", "arguments": {} }
# { "name": "get_lineage", "arguments": { "node_name": "my_model" } }

Requires Python 3.12 (supports_current). You must have dbt credentials configured (dbt Cloud API token or local dbt project) and a running dbt environment to connect to; the server itself does not operate standalone.

Verify before relying:

- Whether all 14 runtime dependencies are required for basic operation or if some are optional based on which tools are used
- Performance characteristics when querying large dbt projects or executing complex lineage operations
- Whether the MCP server can be embedded in applications or is intended only for standalone agent integration

## Package facts

- License: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 115.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mcp server for dbt, dbt agent integration, ai agent dbt context, dbt discovery api tools, model context protocol dbt, dbt semantic layer queries, dbt cli via mcp, mcp-server, dbt-integration, ai-agent-tools

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