Skip to content
appsgit

Dbt MCP

Dbt MCP is an MCP server that adds data and analytics tools to AI assistants such as Claude Desktop, Claude Code and Cursor. A MCP (Model Context Protocol) server for interacting with dbt. It has 607 GitHub stars, is released under the Apache-2.0 license and runs locally with uvx dbt-mcp.

github.com/dbt-labs/dbt-mcp (opens in a new tab)

Install Dbt MCP

Generated from the server's published package. Replace your-value with your own values.

Claude Desktop

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --transport stdio dbt-mcp -- uvx dbt-mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "dbt-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "dbt-mcp"
      ]
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "servers": {
    "dbt-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "dbt-mcp"
      ]
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Tools (40)

Parsed from the Tools section of the README; check the repository for the current list.

  • execute_sql

    Executes SQL on dbt Platform infrastructure with Semantic Layer support.

  • text_to_sql

    Generates SQL from natural language using project context.

  • get_dimension_values

    Gets distinct values for a dimension; option to scope to specific metrics.

  • get_dimensions

    Gets dimensions for specified metrics.

  • get_entities

    Gets entities for specified metrics.

  • get_metrics_compiled_sql

    Returns compiled SQL for metrics without executing the query.

  • list_metrics

    Retrieves all defined metrics.

  • list_saved_queries

    Retrieves all saved queries.

  • query_metrics

    Executes metric queries with filtering and grouping options.

  • get_all_macros

    Retrieves macros; option to filter by package or return package names only.

  • get_all_models

    Retrieves name and description of all models.

  • get_all_sources

    Gets all sources with freshness status; option to filter by source name.

  • get_exposure_details

    (deprecated — use getnodedetails instead)*

  • get_exposures

    Gets all exposures (downstream dashboards, apps, or analyses).

  • get_lineage

    Gets a bounded lineage graph with type, depth, and direction filtering.

  • get_macro_details

    (deprecated — use getnodedetails instead)*

  • get_mart_models

    Retrieves all mart models.

  • get_model_children

    (deprecated — use getlineage instead)*

  • get_model_details

    (deprecated — use getnodedetails instead)*

  • get_model_health

    Gets health signals: run status, test results, and upstream source freshness.

  • get_model_parents

    (deprecated — use getlineage instead)*

  • get_model_performance

    Gets execution history for a model; option to include test results.

  • get_node_details

    Gets full details for any dbt resource type (model, source, exposure, test, seed, snapshot, macro, semantic_model).

  • get_related_models

    Finds similar models using semantic search.

  • get_seed_details

    (deprecated — use getnodedetails instead)*

  • get_semantic_model_details

    (deprecated — use getnodedetails instead)*

  • get_snapshot_details

    (deprecated — use getnodedetails instead)*

  • get_source_details

    (deprecated — use getnodedetails instead)*

  • get_test_details

    (deprecated — use getnodedetails instead)*

  • search

    [Alpha] Searches for resources across the dbt project (not generally available).

  • build

    Executes models, tests, snapshots, and seeds in DAG order.

  • clone

    Clones selected nodes from the specified state to the target schema(s).

  • compile

    Generates executable SQL from models/tests/analyses; useful for validating Jinja logic.

  • docs

    Generates documentation for the dbt project.

  • get_lineage_dev

    Retrieves lineage from local manifest.json with type and depth filtering.

  • get_node_details_dev

    Retrieves node details from local manifest.json (models, seeds, snapshots, sources).

  • list

    Lists resources in the dbt project by type with selector support.

  • parse

    Parses and validates project files for syntax correctness.

  • show

    Executes SQL against the database and returns results.

  • test

    Runs tests to validate data and model integrity.

About Dbt MCP

This MCP (Model Context Protocol) server provides various tools to interact with dbt. You can use this MCP server to provide AI agents with context of your project in dbt Core, dbt Fusion, and dbt Platform.

  • data-analytics
  • data-engineering
  • llm
  • mcp
  • mcp-server
  • model-context-protocol
  • dbt

FAQ

Dbt MCP FAQ

Still curious? Email info@appsgit.com.

What is Dbt MCP?

Dbt MCP is an MCP server that adds data and analytics tools to AI assistants such as Claude Desktop, Claude Code and Cursor. A MCP (Model Context Protocol) server for interacting with dbt. It has 607 GitHub stars, is released under the Apache-2.0 license and runs locally with uvx dbt-mcp. The source code is at github.com/dbt-labs/dbt-mcp.

How do I install the Dbt MCP MCP server?

Add the command uvx dbt-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Dbt MCP free?

The server is open source under the Apache-2.0 license, so running it is free. It does not declare any required API key.

Is Dbt MCP actively maintained?

The most recent commit was on Oct 6, 2026. The latest release is v2.6.0, published Oct 6, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.