{"id":4491,"library":"databricks-mcp","title":"Databricks MCP Helpers","description":"The `databricks-mcp` library provides helper utilities specifically designed for developers interacting with Databricks Workflows and the Databricks Control Plane (MCP). It wraps and extends the `databricks-sdk` to offer higher-level abstractions for common MCP operations, such as deployment stack management. Currently at version `0.9.0`, it is actively developed by DatabricksLabs, with releases tied to internal needs and `databricks-sdk` updates, typically on an infrequent basis.","status":"active","version":"0.9.0","language":"en","source_language":"en","source_url":"https://github.com/databrickslabs/databricks-mcp","tags":["databricks","mcp","control-plane","workflow","deployment","sdk","cloud"],"install":[{"cmd":"pip install databricks-mcp","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"Required Python version","package":"python","version":">=3.10"},{"reason":"Core dependency for interacting with Databricks APIs","package":"databricks-sdk","version":">=0.14.0"}],"imports":[{"symbol":"DatabricksMcpClient","correct":"from databricks_mcp.databricks_mcp_client import DatabricksMcpClient"},{"symbol":"DatabricksMcpConfig","correct":"from databricks_mcp.databricks_config import DatabricksMcpConfig"}],"quickstart":{"code":"import os\nfrom databricks_mcp.databricks_config import DatabricksMcpConfig\nfrom databricks_mcp.databricks_mcp_client import DatabricksMcpClient\n\n# Ensure DATABRICKS_HOST, DATABRICKS_TOKEN, and DATABRICKS_ACCOUNT_ID\n# are set as environment variables for a real connection.\n# Token should be a Databricks Account-level token.\n\ntry:\n    config = DatabricksMcpConfig(\n        host=os.environ.get(\"DATABRICKS_HOST\", \"https://accounts.cloud.databricks.com\"),\n        token=os.environ.get(\"DATABRICKS_TOKEN\", \"dapi-example-token\"),\n        account_id=os.environ.get(\"DATABRICKS_ACCOUNT_ID\", \"00000000-0000-0000-0000-000000000000\"),\n    )\n    client = DatabricksMcpClient(config)\n    print(f\"Databricks MCP Client initialized successfully for host: {client.config.host}\")\n    # The client object contains underlying databricks_sdk clients (e.g., client.account_client)\n    # which can be used to perform actual operations. This quickstart only demonstrates initialization.\n\nexcept Exception as e:\n    print(f\"Failed to initialize Databricks MCP Client: {e}\")\n    print(\"Please ensure DATABRICKS_HOST, DATABRICKS_TOKEN, and DATABRICKS_ACCOUNT_ID\")\n    print(\"environment variables are correctly configured and point to your Databricks Account.\")","lang":"python","description":"Initialize the `DatabricksMcpClient` by providing configuration, typically sourced from environment variables. This example demonstrates basic client instantiation, which validates your host and token against expected formats but doesn't make an external API call by default unless you interact with `client.account_client` or similar."},"warnings":[{"fix":"Always pin exact versions in production environments (`databricks-mcp==0.9.0`) and thoroughly test updates before deployment.","message":"The library is currently at version `0.x.x` (pre-1.0), meaning API stability is not guaranteed. Breaking changes may be introduced in minor or patch releases without strict semantic versioning.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Ensure `DATABRICKS_TOKEN` is an Account-level token obtained from your Databricks Account settings and that all three environment variables are correctly set before initializing `DatabricksMcpConfig`.","message":"Authentication requires specific environment variables (`DATABRICKS_HOST`, `DATABRICKS_TOKEN`, `DATABRICKS_ACCOUNT_ID`). A common mistake is using a Databricks Workspace token instead of an Account-level token, which is necessary for Control Plane operations.","severity":"gotcha","affected_versions":"All"},{"fix":"Keep `databricks-mcp` and `databricks-sdk` versions synchronized and regularly check the release notes for both libraries. Consider pinning specific versions of `databricks-sdk` if stability is critical.","message":"`databricks-mcp` is a wrapper around `databricks-sdk`. If `databricks-sdk` introduces breaking changes or significant behavioral shifts that `databricks-mcp` does not immediately accommodate, it can lead to unexpected errors.","severity":"gotcha","affected_versions":"All"},{"fix":"Evaluate your use case; if it doesn't involve account-level management or complex deployment stacks across workspaces/accounts, the `databricks-sdk` might suffice.","message":"This library is primarily for Databricks Control Plane (MCP) interactions and complex workflows. For simpler workspace-level operations (e.g., managing notebooks, jobs, clusters within a single workspace), directly using the `databricks-sdk` might be more appropriate and less complex.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"last_verified":"2026-04-12T00:00:00.000Z","next_check":"2026-07-11T00:00:00.000Z"}