Manage workspace files and notebooks
manage_workspace_filesManage Databricks workspace files, notebooks, and folders: list, inspect, export/import content, create directories, or delete objects via the Workspace API.
Instructions
Manage Databricks workspace files, notebooks and folders (Workspace API).
list (path[, recursive]), get_status (path): metadata (type, language, size, object_id).
export (path[, format, local_path]): text content inline (UTF-8) or base64 for binary; capped by DBX_MCP_MAX_INLINE_DOWNLOAD_BYTES; with local_path the file is written under DBX_MCP_LOCAL_FILE_ROOT.
import (path, content | content_base64 | local_path[, language, format, overwrite]): create or update a file or notebook (10 MB limit). Notebooks: language=PYTHON|SQL|SCALA|R with format SOURCE (default when language is set) or JUPYTER (.ipynb content). overwrite=true is DESTRUCTIVE (confirm required).
mkdirs (path): create directory and parents.
delete (path[, recursive]): DESTRUCTIVE, confirm required.
Safety classification: depends on input (DESTRUCTIVE, READ_ONLY, WRITE).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute workspace path, e.g. /Users/me@x.com/project/nb. | |
| action | Yes | list: directory contents; get_status: object metadata; export: download content (inline or to local_path); import: upload/create/update a file or notebook; mkdirs: create directories; delete: delete object (recursive for non-empty directories). | |
| format | No | export/import format. Export default: SOURCE for notebooks, AUTO otherwise. Import default: SOURCE when language is set (notebook), else AUTO (file, or notebook if the content has a notebook header). RAW is import-only. | |
| confirm | No | Set to true ONLY after the user has reviewed the plan returned by a previous call with status 'confirmation_required'. Required for destructive/security-sensitive actions. | |
| content | No | import: text content (UTF-8). | |
| dry_run | No | If true, validate and return the planned change without executing it. | |
| language | No | import: notebook language (required for a single SOURCE notebook). | |
| overwrite | No | import: replace an existing object (DESTRUCTIVE); export: replace a local file. | |
| page_size | No | Max items to return (server caps this). | |
| recursive | No | list: walk sub-directories (files only); delete: delete non-empty directory. | |
| local_path | No | import: read from / export: write to this path relative to DBX_MCP_LOCAL_FILE_ROOT. | |
| page_token | No | next_page_token from a previous response. | |
| content_base64 | No | import: binary content, base64-encoded. | |
| create_parents | No | import: create missing parent directories. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| page | No | ||
| plan | No | ||
| tool | Yes | ||
| action | No | ||
| safety | No | ||
| status | No | success | |
| summary | Yes | ||
| warnings | No | ||
| next_steps | No | Suggested follow-up calls. | |
| request_id | No |