dbtMCP Server

by dbt Labs

Added to Onei Jul 29, 2026

v1.22.1

Apache License Version 2.

Repository Docs

Databases & Data

Summary

dbt Labs' official MCP server — explore project metadata, run dbt commands, and query the Semantic Layer.

Features

Explore models, sources, and lineage in a dbt project
Run dbt commands and read the results
Query the Semantic Layer for governed metrics

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it.
Restart the agent — the "dbt" tools will be available.

{
  "mcpServers": {
    "dbt": {
      "command": "uvx",
      "args": [
        "dbt-mcp"
      ]
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add dbt -- uvx dbt-mcp

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "dbt": {
      "command": "uvx",
      "args": [
        "dbt-mcp"
      ]
    }
  }
}

Cursor

{
  "command": "uvx",
  "args": [
    "dbt-mcp"
  ]
}

Windsurf

{
  "command": "uvx",
  "args": [
    "dbt-mcp"
  ]
}

VS Code

{
  "command": "uvx",
  "args": [
    "dbt-mcp"
  ]
}

Description

dbt Labs' official MCP server connects an assistant to a dbt project and, if you use dbt Cloud, to its metadata and Semantic Layer.

Three areas of capability

Project discovery. List models, sources, and tests; read model definitions; and trace lineage upstream and downstream. This is the fastest way to answer "what feeds this table and what breaks if I change it".
Command execution. Run dbt build, run, test, and compile and read the output, so an assistant can iterate on a model until its tests pass.
Semantic Layer queries. Ask for a metric by name and get governed, consistent numbers rather than a hand-written SQL approximation that quietly disagrees with the dashboard.

Why the Semantic Layer part matters

The recurring problem with AI querying a warehouse is that it invents its own definition of a metric. Routing through the Semantic Layer means "revenue" means what your organisation has agreed it means.

Installed with uvx dbt-mcp, configured with your project directory and, optionally, dbt Cloud credentials.

Related MCP Servers

MCP: Tableau MCP

by Tableau

Featured

Tableau's own MCP server — query published data sources, explore workbooks and views, and render live vizzes inside an AI client.

Databases & Data

MCP: Data Commons MCP Server

by Data Commons

Query public statistics — health, economic, demographic and climate indicators from hundreds of official sources — through the Data Commons knowledge graph, hosted or self-run.

Databases & Data

MCP: MotherDuck / DuckDB

by MotherDuck

Run DuckDB analytics locally or in MotherDuck's cloud — query files and warehouses with the same SQL.

Databases & Data

MCP: Senzing MCP Server

by Senzing

Teaches an agent to build on Senzing entity resolution: a guided data-mapping workflow, SDK scaffolds in four languages, doc search and 456+ error-code explanations.

Databases & Data

Browse all MCP servers →