Installation

Prerequisites

• Claude Code or Cursor installed and working
• A Databricks workspace with a personal access token or CLI profile configured
• Databricks CLI installed (brew install databricks or pip install databricks-cli)

Quick Install

The one-liner installer configures the MCP server and skills for Claude Code and Cursor automatically. Run it from any project directory:

Mac / Linux

curl -sL https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/install.sh | bash

Follow the interactive prompts to select your Databricks profile and tools.

Windows (PowerShell)

irm https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/install.ps1 | iex

Follow the interactive prompts to select your Databricks profile and tools.

Installs at project level by default — run your AI tool from the same directory. Optional flags:

Flag	Effect
--global	Install system-wide instead of project-level
--tools cursor	Install for Cursor only
--force	Overwrite an existing installation

Skip to Verify Installation if you used the quick installer.

Manual Setup

If you prefer to install each component separately, follow these steps.

Install Skills

Skills teach Claude Code how to work with Databricks services. Install them with a single command:

claude skill install databricks-solutions/ai-dev-kit

This installs all skills covering data engineering, SQL analytics, AI/ML, app development, governance, and DevOps.

Install MCP Server

The MCP server gives Claude Code direct access to your Databricks workspace — running SQL, managing pipelines, deploying apps, and more.

Add the following to your Claude Code MCP configuration (.claude/settings.json or via claude mcp add):

{
  "mcpServers": {
    "ai-dev-kit": {
      "command": "uvx",
      "args": [
        "databricks-ai-dev-kit"
      ],
      "env": {
        "DATABRICKS_HOST": "https://your-workspace.cloud.databricks.com",
        "DATABRICKS_TOKEN": "your-personal-access-token"
      }
    }
  }
}

See Configuration for alternative authentication methods (CLI profiles, OAuth M2M).

Verify Installation

Ask Claude Code to confirm everything is connected:

What Databricks skills do you have access to?

Claude should list the installed skills. Then verify MCP connectivity:

List the catalogs in my workspace

If both commands succeed, you’re ready to go. Head to the Quick Start to try your first prompts, or browse the Skills Catalog to see what’s available.