dbt MCP Server

Databasestdiov0.5.0
Repository

Official dbt Labs MCP server for analytics engineering workflows. Lets AI agents run dbt commands (build, run, test), inspect models and lineage via the dbt project, and query the Semantic Layer and Discovery API in dbt Cloud. Useful for transforming data, validating models, and answering metric questions grounded in governed definitions.

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "dbt": {
      "command": "uvx",
      "args": [
        "dbt-mcp"
      ],
      "env": {
        "DBT_HOST": "<YOUR_DBT_HOST>",
        "DBT_TOKEN": "<YOUR_DBT_TOKEN>",
        "DBT_PROJECT_DIR": "<YOUR_DBT_PROJECT_DIR>"
      }
    }
  }
}

Tools (2)

run_models

Run dbt models with optional selectors and return execution results.

{
  "type": "object",
  "properties": {
    "select": {
      "type": "string",
      "description": "dbt node selection syntax (e.g., a model or tag)"
    }
  }
}

query_metrics

Query the dbt Semantic Layer for governed metrics and dimensions.

{
  "type": "object",
  "required": [
    "metrics"
  ],
  "properties": {
    "metrics": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Metric names to query"
    },
    "group_by": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Dimensions to group by"
    }
  }
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server Information

Author
dbt Labs (@dbt-labs)
Repository
https://github.com/dbt-labs/dbt-mcp
License
Apache-2.0
Version
0.5.0
Stars
640
Last Updated
July 9, 2026