How do I install the Databricks Connect skill?

Run npx skillmds@latest add santoshkanthety/databricks-connect in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Databricks Connect skill do?

Connecting to Databricks It is listed under Coding & Dev Tools on SkillMD.

Is Databricks Connect safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Databricks Connect?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Databricks Connect free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Databricks Connect?

santoshkanthety (@santoshkanthety) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Databricks Connect by santoshkanthety

Name: Databricks Connect
Author: santoshkanthety

File contents

Connecting to Databricks

Quick Start

# Step 1: Install databricks-agent
pip install "databricks-agent[all]"

# Step 2: Connect to your workspace
databricks-agent connect

# Step 3: Verify connection
databricks-agent doctor

# Step 4: Install Claude Code skills
databricks-agent skills install

Connection Methods

Method 1: Interactive Setup (Recommended)

databricks-agent connect
# Prompts for:
#   Workspace URL: https://adb-1234567890.azuredatabricks.net
#   Authentication: [1] PAT token  [2] OAuth (browser)
#   Default warehouse (optional)
#   Default catalog (optional)

Method 2: Environment Variables

export DATABRICKS_HOST="https://adb-1234567890.azuredatabricks.net"
export DATABRICKS_TOKEN="dapi1234567890abcdef"

# Or for OAuth M2M
export DATABRICKS_CLIENT_ID="your-service-principal-client-id"
export DATABRICKS_CLIENT_SECRET="your-service-principal-secret"

Method 3: Databricks Config File (~/.databrickscfg)

[DEFAULT]
host  = https://adb-1234567890.azuredatabricks.net
token = dapi1234567890abcdef

[dev]
host  = https://adb-0987654321.azuredatabricks.net
token = dapi0987654321abcdef

# Use a specific profile
databricks-agent connect --profile dev

# List configured profiles
databricks-agent connect --list

Switching Workspaces

# Connect to a different workspace
databricks-agent connect --host https://adb-9876543210.azuredatabricks.net

# Switch active profile
databricks-agent connect --profile prod

Troubleshooting

Error	Cause	Fix
`401 Unauthorized`	Invalid or expired token	Regenerate PAT in workspace Settings → Developer
`403 Forbidden`	Missing permissions	Ask admin for `CAN USE` on warehouse or cluster
`Connection timed out`	Firewall / VPN	Ensure VPN is connected, check network ACLs
`Workspace not found`	Wrong host URL	Verify URL format: `https://adb-XXXXX.Y.azuredatabricks.net`
`No warehouses found`	No SQL Warehouse created	Create one in workspace or request from admin
`databricks SDK not found`	Missing dependency	Run `pip install databricks-sdk`

# Full environment diagnostics
databricks-agent doctor

Installation Options

# Core only (CLI, no web UI)
pip install databricks-agent

# With web configuration UI
pip install "databricks-agent[ui]"

# With ML/MLflow support
pip install "databricks-agent[ml]"

# Everything
pip install "databricks-agent[all]"

Generating a PAT Token

Open your Databricks workspace
Click your username (top-right) → Settings
Click Developer → Access Tokens → Generate new token
Set a description and expiry
Copy the token immediately (shown once)
Run databricks-agent connect and paste the token

---name: databricks-connectdescription: Connecting to Databricks---# Connecting to Databricks## Quick Start```bash# Step 1: Install databricks-agentpip install "databricks-agent[all]"# Step 2: Connect to your workspacedatabricks-agent connect# Step 3: Verify connectiondatabricks-agent doctor# Step 4: Install Claude Code skillsdatabricks-agent skills install```## Connection Methods### Method 1: Interactive Setup (Recommended)```bashdatabricks-agent connect# Prompts for:# Workspace URL: https://adb-1234567890.azuredatabricks.net# Authentication: [1] PAT token [2] OAuth (browser)# Default warehouse (optional)# Default catalog (optional)```### Method 2: Environment Variables```bashexport DATABRICKS_HOST="https://adb-1234567890.azuredatabricks.net"export DATABRICKS_TOKEN="dapi1234567890abcdef"# Or for OAuth M2Mexport DATABRICKS_CLIENT_ID="your-service-principal-client-id"export DATABRICKS_CLIENT_SECRET="your-service-principal-secret"```### Method 3: Databricks Config File (~/.databrickscfg)```ini[DEFAULT]host = https://adb-1234567890.azuredatabricks.nettoken = dapi1234567890abcdef[dev]host = https://adb-0987654321.azuredatabricks.nettoken = dapi0987654321abcdef``````bash# Use a specific profiledatabricks-agent connect --profile dev# List configured profilesdatabricks-agent connect --list```## Switching Workspaces```bash# Connect to a different workspacedatabricks-agent connect --host https://adb-9876543210.azuredatabricks.net# Switch active profiledatabricks-agent connect --profile prod```## Troubleshooting| Error | Cause | Fix ||-------|-------|-----|| `401 Unauthorized` | Invalid or expired token | Regenerate PAT in workspace Settings → Developer || `403 Forbidden` | Missing permissions | Ask admin for `CAN USE` on warehouse or cluster || `Connection timed out` | Firewall / VPN | Ensure VPN is connected, check network ACLs || `Workspace not found` | Wrong host URL | Verify URL format: `https://adb-XXXXX.Y.azuredatabricks.net` || `No warehouses found` | No SQL Warehouse created | Create one in workspace or request from admin || `databricks SDK not found` | Missing dependency | Run `pip install databricks-sdk` |```bash# Full environment diagnosticsdatabricks-agent doctor```## Installation Options```bash# Core only (CLI, no web UI)pip install databricks-agent# With web configuration UIpip install "databricks-agent[ui]"# With ML/MLflow supportpip install "databricks-agent[ml]"# Everythingpip install "databricks-agent[all]"```## Generating a PAT Token1. Open your Databricks workspace2. Click your username (top-right) → **Settings**3. Click **Developer** → **Access Tokens** → **Generate new token**4. Set a description and expiry5. Copy the token immediately (shown once)6. Run `databricks-agent connect` and paste the token

Frequently asked questions

Databricks Connect