Install Bruin

What is this? A quick setup guide that gets you ready to build data pipelines with Bruin. You'll install the CLI, the VS Code extension, and optionally connect an AI coding assistant via the Bruin MCP.

What you'll set up: The Bruin CLI for running pipelines from the terminal, the VS Code extension for a visual pipeline development experience, and the Bruin MCP to let AI tools like Claude Code or Cursor work directly with your pipelines and data.

How long? About 10 minutes. Most of the tools install with a single command.

Start setup →

Full guide

Below is the complete setup guide you can read through, or use the step-by-step version above.

Install the Bruin CLI

Run this command in your terminal (macOS, Linux, or Windows via Git Bash/WSL):

curl -LsSf https://getbruin.com/install/cli | sh

Or with wget:

wget -qO- https://getbruin.com/install/cli | sh

Verify the installation:

bruin version

If you get a Permission Denied error, run with sudo:

curl -LsSf https://getbruin.com/install/cli | sudo sh

Install the VS Code extension

1. Open VS Code
2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
3. Search for Bruin
4. Click Install

The extension gives you syntax highlighting, autocompletion, data lineage visualization, query preview, and a visual interface for running pipelines - all inside your editor.

Set up the Bruin MCP (optional)

The Bruin MCP lets AI coding tools query your data, build pipelines, and look up Bruin documentation directly. Pick the tool you use:

Claude Code:

claude mcp add bruin -- bruin mcp

Cursor: Go to Settings > MCP & Integrations > Add Custom MCP:

{
  "mcpServers": {
    "bruin": { "command": "bruin", "args": ["mcp"] }
  }
}

VS Code (Copilot): Add to your mcp.json:

{
  "servers": {
    "bruin": { "type": "stdio", "command": "bruin", "args": ["mcp"] }
  }
}

Codex CLI: Add to ~/.codex/config.toml:

[mcp_servers.bruin]
command = "bruin"
args = ["mcp"]

Restart your AI tool after adding the MCP. To verify, ask it: "What connections are available in this Bruin project?"