dbt Cloud MCP — Auth Setup
dbt Cloud uses an API key and account ID to authenticate requests to your dbt Cloud environment.
1. Get your credentials
- Open dbt Cloud Settings (opens dbt Cloud — we never see your key)
- Navigate to Profile > API Access to find or generate your personal API key
- Your Account ID appears in the URL when you are on any account page:
cloud.getdbt.com/#/accounts/<account_id>/
2. Set environment variables
macOS / Linux — add to ~/.zshrc or ~/.bashrc:
export DBT_CLOUD_API_KEY=YOUR_API_KEY_HERE
export DBT_ACCOUNT_ID=YOUR_ACCOUNT_ID_HERE
Then run source ~/.zshrc (or open a new terminal).
Windows — run in Command Prompt (then restart):
setx DBT_CLOUD_API_KEY "YOUR_API_KEY_HERE"
setx DBT_ACCOUNT_ID "YOUR_ACCOUNT_ID_HERE"
3. Verify
npx claude-skills doctor
You should see ✅ next to the dbt Cloud MCP entry. If you see ❌, confirm the key is set: echo $DBT_CLOUD_API_KEY.
4. Restart Claude Code
Quit and reopen Claude Code (or run /mcp list inside Claude Code to confirm the dbt Cloud MCP appears).

