Databricks Workspace Mcp

An MCP server for the Databricks control plane — cluster forensics, instance-pool waste, DLT pipeline event logs, and Unity Catalog storage governance. These are the eight read-only tools that no managed Databricks MCP exposes. Pair this server with the managed SQL MCP for system.* reads.

• License: MIT
• Transport: MCP over stdio and HTTP
• Access: Read-only

Why this server exists

Databricks ships five managed MCP servers (Genie, Genie Space, Vector Search, Databricks SQL, Unity Catalog Functions) — all data plane. None of them expose live control-plane state: cluster event timelines, instance-pool idle stats, DLT pipeline event logs, or the Unity Catalog external-location / storage-credential wiring. That's the gap this server fills.

The split is deliberate. A consuming skill calls this server for typed control-plane state, and the managed Databricks SQL MCP (/api/2.0/mcp/sql) for everything in system.* (billing, audit, information_schema) — OAuth- and UC-governed on Databricks' side. Two MCPs, one diagnostic picture; no skill should ever have to shell out to the databricks CLI to fill a gap.

Everything here is read-only — no create/edit/terminate. It inventories and diagnoses; it does not mutate your workspace.

Tool surface (8)

Auth — three flows

Resolution is lazy: the server starts and tools/list succeeds even with no credentials, so a consuming skill can detect "MCP present but unauthenticated" and degrade cleanly. Set DATABRICKS_HOST plus one credential:

See .env.example for the full template.

Install

A) Claude Code / any .mcp.json consumer (stdio)

{
  "mcpServers": {
    "databricks-workspace": {
      "command": "npx",
      "args": ["-y", "@intentsolutions/databricks-workspace-mcp"],
      "env": {
        "DATABRICKS_HOST": "https://dbc-xxxx.cloud.databricks.com",
        "DATABRICKS_TOKEN": "dapi..."
      }
    }
  }
}

B) Databricks App (HTTP, OAuth M2M)

The same codebase serves over Streamable HTTP for deployment as a custom Databricks App, which makes the control-plane tools discoverable by the Mosaic AI Agent Framework and the AI Playground in addition to Claude Code. PAT is unsupported in this mode — use a service principal (DATABRICKS_CLIENT_ID / DATABRICKS_CLIENT_SECRET).

Develop

pnpm install
pnpm build        # tsc → dist/, chmods dist/index.js executable
pnpm check        # typecheck + vitest (run against recorded fixtures, no live workspace)
pnpm dev          # tsc --watch

Tests run entirely against recorded JSON fixtures in tests/fixtures/ — no Databricks workspace or credentials required to run the suite.

License

MIT © Jeremy Longshore / Intent Solutions