Databricks MCP Server App MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add databricks-mcp-app -- npx -y @databricks/ai-dev-kit
README.md

Host the AI Dev Kit MCP server as a Databricks App

Databricks MCP Server App

Host the AI Dev Kit MCP server as a Databricks App — letting you experience 80+ Databricks tools from the AI Playground, no local setup required.

What This Is

A 3-file wrapper that takes the open-source databricks-mcp-server from the Databricks Solutions team (stdio transport) and deploys it as a Databricks App with Streamable HTTP transport. The Playground auto-discovers all tools.

app.py            # 4 lines — import server, expose as HTTP
app.yaml          # Databricks App config
requirements.txt  # Pull ai-dev-kit from GitHub
databricks.yml    # Databricks Asset Bundle config

Setup

Prerequisites

  • Databricks CLI v0.229.0+ (databricks --version)
  • A Databricks workspace with Apps enabled
  • Authenticated CLI profile (databricks auth login --host <url>)

Deploy

This project uses Databricks Asset Bundles for deployment.

# Authenticate
databricks auth login --host https://your-workspace.cloud.databricks.com

# Validate the bundle
databricks bundle validate

# Deploy the app resource and sync source code
databricks bundle deploy

# Start the app (installs packages and launches the server)
databricks bundle run mcp_ai_dev_kit

# If using a named CLI profile, add --profile to each command:
databricks bundle deploy --profile 
databricks bundle run mcp_ai_dev_kit --profile 

Important: The app name must start with mcp- for the Playground to discover it as a custom MCP server. The default name mcp-ai-dev-kit already handles this.

Connect to AI Playground

  1. Open your workspace → AI Playground
  2. Select a model with the Tools enabled label
  3. Click ToolsAdd toolMCP Servers
  4. Add your app's MCP endpoint: https://<app-url>/mcp
  5. The Playground auto-discovers all 80+ tools

Demo Script: Usage Dashboard in 3 Prompts

Once connected in the Playground:

  1. "Query system.billing.usage and show me total DBUs by sku_name for the last 30 days" → Uses SQL tools

  2. "Create a view called main.default.monthly_usage_summary that aggregates DBUs from system.billing.usage by month and sku_name" → Uses SQL tools

  3. "Build a clean AI/BI dashboard that shows weekly and monthly usage trends from that view — a line chart for weekly DBUs over time and a bar chart for monthly DBUs by SKU" → Uses Dashboard tools

Switch to the workspace UI — a published Lakeview dashboard, built from conversation.

Architecture

AI Playground ──Streamable HTTP──▶ Databricks App (this repo)
                                        │
                                        ▼
                                  ai-dev-kit MCP Server
                                  (80+ tools via FastMCP)
                                        │
                                        ▼
                              Databricks APIs (SDK)
                              ├── SQL Warehouses
                              ├── Unity Catalog
                              ├── Jobs / Pipelines
                              ├── Vector Search
                              ├── Model Serving
                              ├── Agent Bricks
                              ├── AI/BI Dashboards
                              ├── Genie
                              └── ...

Tools (3)

sql_queryExecute SQL queries against Databricks SQL warehouses.
unity_catalog_listList resources within the Unity Catalog.
dashboard_createCreate or manage AI/BI dashboards.

Configuration

claude_desktop_config.json
{ "mcpServers": { "databricks-ai-dev-kit": { "command": "npx", "args": ["-y", "@databricks/ai-dev-kit"] } } }

Try it

Query system.billing.usage and show me total DBUs by sku_name for the last 30 days
Create a view called main.default.monthly_usage_summary that aggregates DBUs from system.billing.usage by month and sku_name
Build a clean AI/BI dashboard that shows weekly and monthly usage trends from that view — a line chart for weekly DBUs over time and a bar chart for monthly DBUs by SKU

Frequently Asked Questions

What are the key features of Databricks MCP Server App?

Exposes over 80 Databricks tools via FastMCP. Deploys as a Databricks App with Streamable HTTP transport. Enables natural language interaction with SQL warehouses and Unity Catalog. Supports automated AI/BI dashboard creation. Integrates directly with Databricks AI Playground.

What can I use Databricks MCP Server App for?

Analyzing cloud billing and DBU usage trends using natural language. Automating the creation of Lakeview dashboards from SQL query results. Managing Unity Catalog assets and schemas through conversational AI. Querying workspace resources without manual SQL warehouse configuration.

How do I install Databricks MCP Server App?

Install Databricks MCP Server App by running: databricks bundle deploy && databricks bundle run mcp_ai_dev_kit

What MCP clients work with Databricks MCP Server App?

Databricks MCP Server App works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Databricks MCP Server App docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare