databricks-config
About databricks-config
databricks-config is a skill for guiding agents through Databricks workspace management via an MCP tool. It covers checking, listing, switching, and logging into workspaces, and notes that switching lasts only for the current session.
Key features
- 01Check current workspace status
- 02List available workspaces
- 03Switch workspace configuration
- 04Log in or connect to a workspace
- 05Present operation results
Use cases
- 01Verify the connected workspace
- 02Find and switch to a workspace
- 03Authenticate with a workspace
MCP support
The skill requires the Databricks manage_workspace MCP tool for workspace operations and instructs agents to load it through ToolSearch first.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ databricks-solutions/ ai-dev-kit --skill databricks-configAfter installing, type/databricks-configin Claude Code to confirm it loaded.
Details
From the project READMEUse the manage_workspace MCP tool for all workspace operations. Do NOT edit ~/.databrickscfg, use Bash, or use the Databricks CLI.
Steps
-
Call
ToolSearchwith queryselect:mcp__databricks__manage_workspaceto load the tool. -
Map user intent to action:
- status / which workspace / current →
action="status" - list / available workspaces →
action="list" - switch to X → call
listfirst to find the profile name, thenaction="switch", profile="<name>"(orhost="<url>"if a URL was given) - login / connect / authenticate →
action="login", host="<url>"
- status / which workspace / current →
-
Call
mcp__databricks__manage_workspacewith the action and any parameters. -
Present the result. For
status/switch/login: show host, profile, username. Forlist: formatted table with the active profile marked.
Note: The switch is session-scoped — it resets on MCP server restart. For permanent profile setup, use
databricks auth login -p <profile>and update~/.databrickscfgwithcluster_idorserverless_compute_id = auto.