A Model Context Protocol (MCP) server that wraps the dbt CLI tool, enabling AI coding agents to interact with dbt projects through standardized MCP
Dbt cli mcp mcp server connects Dbt Cli MCP to AI assistants that speak the Model Context Protocol. A Model Context Protocol (MCP) server that wraps the dbt CLI tool, enabling AI coding agents to interact with dbt projects through standardized MCP tools.
A Model Context Protocol (MCP) server that wraps the dbt CLI tool, enabling AI coding agents to interact with dbt projects through standardized MCP tools.
Once connected, the assistant can call these 10 tools directly:
dbt_run — Run dbt models (requires absolute project_dir)dbt_test — Run dbt tests (requires absolute project_dir)dbt_ls — List dbt resources (requires absolute project_dir)dbt_compile — Compile dbt models (requires absolute project_dir)dbt_debug — Debug dbt project setup (requires absolute project_dir)dbt_deps — Install dbt package dependencies (requires absolute project_dir)dbt_seed — Load CSV files as seed data (requires absolute project_dir)dbt_show — Preview model results (requires absolute project_dir)Prerequisites — The Prerequisites tool exposed by this serverSetup — The Setup tool exposed by this serverSetup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.
The server reads 2 environment variables: DBT_PATH, ENV_FILE. Keep credentials in your client's env block or a secrets manager rather than committing them.
uv tool for Python environment management - dbt CLI installedDeveloper-tool servers are usually the first ones people connect, because they turn "help me with this code" into an assistant that can actually read the repo and act on it. Dbt Cli MCP sits in that group, and the shape of its toolset — dbt_run, dbt_test, dbt_ls among others — tells you what it is really for. Worth comparing against the other developer tools servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.
| Tool | What it does |
|---|---|
| dbt_run | Run dbt models (requires absolute project_dir) |
| dbt_test | Run dbt tests (requires absolute project_dir) |
| dbt_ls | List dbt resources (requires absolute project_dir) |
| dbt_compile | Compile dbt models (requires absolute project_dir) |
| dbt_debug | Debug dbt project setup (requires absolute project_dir) |
| dbt_deps | Install dbt package dependencies (requires absolute project_dir) |
| dbt_seed | Load CSV files as seed data (requires absolute project_dir) |
| dbt_show | Preview model results (requires absolute project_dir) |
| Prerequisites | The Prerequisites tool exposed by this server. |
| Setup | The Setup tool exposed by this server. |
{
"mcpServers": {
"dbt": {
"command": "uv",
"args": ["--directory", "/path/to/dbt-cli-mcp", "run", "src/server.py"],
"env": {
"DBT_PATH": "/absolute/path/to/dbt",
"ENV_FILE": ".env"
// You can also set DBT_PROFILES_DIR here for a server-wide default
}
}
}
}Configuration as documented by the project. Restart the client after saving.
uv tool for Python environment management - dbt CLI installed| Variable | Description | Required |
|---|---|---|
| DBT_PATH | Filesystem location the server is allowed to use. | Optional |
| ENV_FILE | Configuration value read at startup. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.