MCP App Store
by KeenEthics
Dropbox icon

Dropbox MCP Server for Claude and ChatGPT

By Dropbox

Overview

The Dropbox plugin for Claude connects your Dropbox files directly to Claude, so you can search, organize, save generated content, and create sharing links without switching tools. It respects your existing Dropbox permissions, and Claude only works with files you already have access to.

How to connect

  1. Claude: Open the Dropbox plugin listing for Claude and install it in Claude Code. Claude listing Dropbox exposes 19 tools here.
  2. ChatGPT: Open the Dropbox listing in the ChatGPT app directory and choose Connect. ChatGPT listing Dropbox exposes 50 tools here.

Tools

check_job_status

ChatGPT
Tool Name: dropbox.check_job_status Purpose: Poll an async move, copy, delete, or restore_folder operation. REQUEST CONTRACT: - operation_id (required): the opaque token returned by move, copy, delete, or restore_folder. - wait_ms (optional): wait budget in milliseconds. Omitted or 0 performs one immediate status check. Positive values ask the server to wait briefly for completion. Maximum 30000ms; values >30000 or negative are rejected with INVALID_WAIT_MS. RESPONSE CONTRACT: - status: "completed" or "in_progress". - operation_id: echoed when status="in_progress". Pass it back unchanged for the next poll. - recommended_poll_after_ms: suggested delay before the next poll. - When status="completed", result_type and the populated result field are: - result_type="move" with move_result. - result_type="copy" with copy_result. - result_type="delete" with delete_result. - result_type="restore_folder" with restore_folder_result. ASSISTANT POLICY: - Use this tool only when move, copy, delete, or restore_folder returns an operation_id. - Do not assume every async Fileverse MCP tool uses check_job_status. Follow the submission tool's polling instructions. - Pass operation_id back verbatim. Do not alter, truncate, or encode/decode it. - Respect recommended_poll_after_ms; do not poll in a tight loop. - When status becomes "completed", read result_type and use the matching result field listed above. - Follow the submission tool's instructions for operation-specific results, errors, retries, and user-facing guidance. EXAMPLES: {"operation_id": "<token from previous in_progress response>"} {"operation_id": "<token>", "wait_ms": 5000}

check_upload_file_status

ChatGPT
Tool Name: dropbox.check_upload_file_status Purpose: Poll an in-progress upload_file operation. REQUEST CONTRACT: - operation_id (required): Opaque token returned by upload_file when status="in_progress". - wait_ms (optional): Wait budget in milliseconds. Omitted or 0 performs one immediate status check. Maximum 30000ms. RESPONSE CONTRACT: When status is "in_progress": - status: "in_progress" - operation_id: Pass back unchanged on the next check. - recommended_poll_after_ms: Suggested delay before polling again. When status is "completed": - status: "completed" - file: Saved file metadata with name, path, modified_time, file_id, object_type, file.size, and path_display when available. - modified_time is the server-side modification time, in ISO 8601 format when available. - Prefer path_display when present and non-empty, both when showing the saved file to the user and in follow-on MCP calls. Otherwise use path or file_id exactly as returned. ERRORS: - INVALID_OPERATION_ID: operation_id is missing, malformed, expired, or belongs to a different user. - INVALID_WAIT_MS: wait_ms is negative or greater than 30000. - FETCH_FAILED: Dropbox could not download the source URL. - CONTENT_HASH_MISMATCH: the completed file did not match the expected content hash and cleanup was attempted. ASSISTANT POLICY: - Use only with an operation_id returned by upload_file. - Pass operation_id back verbatim. Do not alter, truncate, or encode/decode it. - Respect recommended_poll_after_ms; do not poll in a tight loop. - Do not claim the file was saved until status="completed". EXAMPLES: {"operation_id": "<token from upload_file>"} {"operation_id": "<token from upload_file>", "wait_ms": 5000}

client_log_proxy

ChatGPT
Internal MCP app widget bridge for client logging events.

copy

ChatGPT
Tool Name: dropbox.copy Purpose: Copy one or more files/folders in Dropbox as a single batch. When to use: Any time the user asks to duplicate files or folders into another location. Prefer copy over download-and-reupload. PATHS: - Each entry's source_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt". - destination_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt"; Dropbox resolves lookup, conflicts, and destination semantics. - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths must be Unicode NFC-normalized; decomposed forms are rejected. - Dropbox may create missing destination parent folders during the copy; no need to pre-create parent folders unless the user explicitly asks. - Paths are case-insensitive; the same entry can cross between fq_path, ns_path, and file_id forms if needed. - Successful entries may return object.path as ns_path and object.path_display as fq_path. Prefer object.path_display when present and non-empty, both when showing paths to the user and in follow-on tool calls. If path_display is absent or empty, fall back to object.path or object.file_id exactly as returned. - Never strip the "ns:<id>//" prefix from returned ns_path values. REQUEST CONTRACT: - entries (required, 1..1000): list of { source_path, destination_path } pairs. - autorename (optional, default false): when true, Dropbox renames the destination to avoid a conflict instead of failing that entry. RESPONSE CONTRACT (flat lifecycle fields, MIRROR of move/delete): When status is "completed": - status: "completed" - result_type: "copy" - copy_result.entries[]: per-entry records in request order. - entry_index: 0-based index into the original entries list. - entry_status: "success" or "failed". - object (on success): { name, file_id, object_type: "file"|"folder", path_display, file.size when file, modified_time }. - failure (on failure): { error_code, message }. When status is "in_progress": - status: "in_progress" - operation_id: opaque token to pass to dropbox.check_job_status. - recommended_poll_after_ms: suggested delay before the next check_job_status call. Job-level failures are returned as tool errors. Per-entry failures are returned in copy_result.entries[] when status is "completed". ERRORS (job-level): - INVALID_REQUEST: entries is empty, nil, or malformed - INVALID_ENTRY: an entries item is missing source_path or destination_path - INVALID_PATH: source_path is not a valid fq_path/ns_path/file_id value, or destination_path is not a valid fq_path/ns_path/file_id value - TOO_MANY_ENTRIES: more than 1000 entries submitted in one call - INVALID_ARGUMENT: Dropbox rejected the batch as malformed ERRORS (per-entry error_code values): - Source lookup failures use from_lookup/ codes, such as from_lookup/not_found, malformed paths, non-file/non-folder targets, restricted content, unsupported content type, or locked content. - Source write failures use from_write/ codes for conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Destination write failures use to/* codes for destination conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Shared-folder, batch, permission/quota, and temporary failures include cant_copy_shared_folder, cant_nest_shared_folder, duplicated_or_nested_paths, too_many_files, cant_transfer_ownership, insufficient_quota, too_many_write_operations, and internal_error. - unknown_error means Dropbox returned an error variant this tool does not recognize. DUPLICATE DESTINATION QUIRK: - For duplicate destinations in one batch, later entries may report from_write/conflict even though the practical cause is a destination collision. Report it to the user as a destination conflict. RETRY GUIDANCE: - If status is "in_progress", call dropbox.check_job_status with the returned operation_id. - Do NOT retry the entire batch on per-entry failures; report the specific failures to the user. - too_many_write_operations and internal_error are transient — retry after a short delay if appropriate. EXAMPLES: {"entries": [{"source_path": "/Docs/report.txt", "destination_path": "/Backup/report.txt"}]} {"entries": [{"source_path": "ns:123//A.txt", "destination_path": "ns:123//Archive/A.txt"}], "autorename": true} {"entries": [{"source_path": "id:AbCd-_12", "destination_path": "/Shared/duplicate.pdf"}]} {"entries": [{"source_path": "/Docs/source.pdf", "destination_path": "id:AbCd-_12/copy.pdf"}]} ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file_id values, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. - For created files or folders, tell the user you can revert by calling dropbox.delete on the returned path_display after separate explicit confirmation. - For deleted files or folders, tell the user they can restore deleted content and include https://help.dropbox.com/delete-restore/recover-deleted-files-folders. - When recovering an older file version is relevant, include https://help.dropbox.com/delete-restore/recover-older-versions. - For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI and include https://help.dropbox.com/share/unshare-folder. - Dropbox path handling: path_display is the preferred path. Always use path_display when it is present and non-empty, both in user-facing output and in follow-on tool calls. If path_display is absent or empty, fall back to the returned path/file_id exactly as provided.

create_file

ChatGPT
Tool Name: dropbox.create_file Purpose: Create a new file with text content in Dropbox. When to use: For creating text-oriented files from inline content only. PATHS (SUPER IMPORTANT): - Input path accepts fq_path or ns_path. - Paths are case-insensitive. - The final path component is the filename to create. - Output file.path is always ns_path. - Never strip the "ns:<id>//" prefix from returned paths. - Team root is not writable for team accounts. Personal account root is writable. - This tool only supports text-oriented files. Allowed extensions: - .abap - .ada - .adp - .ahk - .as - .as3 - .asc - .ascx - .asm - .asp - .aspx - .awk - .bash - .bash_login - .bash_logout - .bash_profile - .bashrc - .bat - .bib - .bsh - .build - .builder - .c - .c++ - .capfile - .cc - .cfc - .cfm - .cfml - .cl - .clj - .cls - .cmake - .cmd - .coffee - .cpp - .cpt - .cpy - .cs - .cshtml - .cson - .csproj - .css - .csv - .ctp - .cxx - .d - .ddl - .di - .dif - .diff - .disco - .dml - .dtd - .dtml - .el - .emakefile - .erb - .erl - .f - .f90 - .f95 - .fs - .fsi - .fsscript - .fsx - .gemfile - .gemspec - .gitconfig - .go - .groovy - .gry - .gvy - .h - .h++ - .haml - .handlebars - .hbs - .hcp - .hh - .hpp - .hrl - .hs - .htc - .htm - .html - .hxx - .idl - .iim - .inc - .inf - .ini - .inl - .ipp - .irbrc - .jade - .jav - .java - .js - .json - .jsp - .jsx - .l - .less - .lhs - .lisp - .log - .lst - .ltx - .lua - .m - .make - .markdn - .markdown - .md - .mdown - .mkdn - .ml - .mli - .mll - .mly - .mm - .mud - .nfo - .opml - .org - .osascript - .out - .p - .pas - .patch - .php - .php2 - .php3 - .php4 - .php5 - .phtml - .pl - .plist - .pm - .pod - .pp - .profile - .properties - .ps1 - .psd1 - .psm1 - .pt - .py - .pyw - .r - .rake - .rb - .rbx - .rc - .re - .readme - .reg - .rest - .resw - .resx - .rhtml - .rjs - .rprofile - .rpy - .rs - .rss - .rst - .rxml - .s - .sass - .scala - .scm - .sconscript - .sconstruct - .script - .scss - .sgml - .sh - .shtml - .sml - .sql - .sty - .swift - .tcl - .tex - .text - .textile - .tld - .tli - .tmpl - .tpl - .tsx - .txt - .vb - .vi - .vim - .wsdl - .xhtml - .xml - .xoml - .xsd - .xsl - .xslt - .yaml - .yaws - .yml - .zsh REQUEST CONTRACT: - path (string, REQUIRED): Full destination path including the filename. - Parent must already exist. - content (string, REQUIRED): UTF-8 text content. Maximum 5MB. RESPONSE CONTRACT: - file: object describing the created file. - name, path, modified_time, file_id - object_type: "file" - file.size: File size in bytes. - path_display: fq_path for human display when populated. - When content is empty, current MCP serialization may omit file.size instead of returning 0. Treat an omitted size as a zero-byte file. ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file IDs, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. For created files or folders, instruct the user to delete them from Dropbox. For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI. ERRORS: - INVALID_PATH: path is empty or missing name component - INVALID_NAME: name contains \ (backslash) - CONTENT_TOO_LARGE: content exceeds 5MB - PARENT_NOT_FOUND: parent path doesn't exist - PARENT_NOT_FOLDER: parent is not a folder - ALREADY_EXISTS: file exists at target - PERMISSION_DENIED: no write access - TEAM_ROOT_NOT_WRITABLE: cannot create files or folders directly in team root RETRY GUIDANCE: - Do NOT retry on TEAM_ROOT_NOT_WRITABLE. Choose a specific folder path instead. EXAMPLES: {"path": "/Documents/notes.txt", "content": "Hello World"} {"path": "ns:123//Code/script.py", "content": "print('hi')"} {"path": "/readme.txt", "content": "Root level file"}

create_file_request

ChatGPT
Tool Name: dropbox.create_file_request Purpose: Create a Dropbox file request that lets other people upload files into a chosen Dropbox destination. When to use: Use this when the user wants a Dropbox file request, upload request, upload link, submission link, or a way for other people to upload, submit, collect, or receive files into the user's Dropbox. This creates a public upload URL for contributors to add files to the chosen destination folder; it is not for giving people view or download access to existing Dropbox content. REQUEST CONTRACT: - Shape: {"title": "<title>", "destination": "/Requests/Invoices", "deadline": "2026-05-04T17:00:00Z", "deadline_allow_late_uploads": "seven_days", "closed": false, "description": "...", "video_project_id": "..."} - title (string, REQUIRED): File request title. Must be non-empty. - destination (string, REQUIRED): Destination folder path. Accepts fq_path, ns_path, or file_id. file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. Dropbox shared/web URLs are not accepted. Dropbox rejects file requests at a team root, such as "/", or the user's personal root, such as "/FirstName LastName"; use a child folder under that folder, such as "/FirstName LastName/Invoices". If the destination folder does not exist and the user has write permission to the parent folder, the destination folder will be created automatically. Avoid surprising destinations; confirm the exact destination with the user before creating. - deadline (string, optional): RFC3339 timestamp, for example "2026-05-04T17:00:00Z". If omitted, the file request has no deadline and accepts uploads indefinitely until the request is manually closed or deleted. Setting a deadline requires an eligible Dropbox plan: Professional, Essentials, Business, Business Plus, Standard, Advanced, or Enterprise. Basic, Plus, and Family accounts cannot set a deadline; Dropbox will reject the request for users on these plans. - deadline_allow_late_uploads (string, optional): Valid only when deadline is present. Allowed values: "one_day", "two_days", "seven_days", "thirty_days", or "always". - closed (bool, optional): Defaults to false. false creates an open request; true creates a closed request. - description (string, optional): Optional instructions shown on the file request. - video_project_id (string, optional): Optional Dropbox video editor project ID for associating uploads from this file request with that project. Only pass this when the user or an upstream Dropbox workflow provides the exact project ID. This tool does not verify the project before creating the file request. If the ID is invalid or inaccessible, later uploads can still succeed, but Dropbox may fail to attach the uploaded files to the video project. RESPONSE CONTRACT: - file_request: Created file request record. - id: File request ID. - url: Public upload URL. - title: File request title. - destination: Destination folder path. - created: ISO 8601 creation timestamp. - deadline: ISO 8601 deadline timestamp. Empty when unset. - deadline_allow_late_uploads: Grace period string. Empty when unset. - is_open: Whether the created request accepts uploads. - file_count: Number of submitted files. - description: Optional description. Empty when unset. - video_project_id: Optional video editor project ID. Empty when unset. ASSISTANT POLICY: - Confirm with the user before calling this tool. - Do not claim the file request was created until this tool returns a successful response. - Return the created file request URL, title, destination, open/closed state, and deadline when present. - Avoid creating requests in unexpected destinations without explicit user confirmation. - If the destination is a team root or the user's personal root, ask the user to confirm a child folder under that folder. Do not silently retry with a guessed child folder. - This tool creates metadata only. It does not update, close, delete, or submit files to a request. - After a successful response that creates an open file request, tell the user they can close it from Dropbox and include https://help.dropbox.com/share/create-file-request. - If the destination folder does not exist and the user has write permission to the parent folder, the destination folder will be created automatically. Do not pass guessed, placeholder, or unverified paths. If the user expects an existing folder, verify the destination before creating the request. - You cannot reliably know the user's plan tier in advance. If the user asks for a deadline and the create call fails with a plan-tier error, do not silently retry without a deadline. Explain that deadlines require an eligible plan (Professional, Essentials, Business, Business Plus, Standard, Advanced, or Enterprise) and obtain a second explicit confirmation from the user before creating the request without a deadline. - If the user is on Basic, Plus, or Family, or declines a deadline, proceed without one and explicitly warn that the request will remain open until they close or delete it. EXAMPLES: {"title": "Invoice uploads", "destination": "/Requests/Invoices"} {"title": "Invoice uploads", "destination": "id:AbCd-_12"} {"title": "Video assets", "destination": "/Projects/Launch", "deadline": "2026-05-04T17:00:00Z", "deadline_allow_late_uploads": "seven_days", "description": "Upload final cuts here."}

create_folder

ChatGPT
Tool Name: dropbox.create_folder Purpose: Create a new folder in Dropbox. PATHS (SUPER IMPORTANT): - Input path accepts fq_path (for example "/Documents/NewFolder") or ns_path (for example "ns:123//Documents/NewFolder"). - Paths are case-insensitive. - The final path component is the new folder name. - Output folder.path is always ns_path. - Never strip the "ns:<id>//" prefix from returned paths. - Team root is not writable for team accounts. Personal account root is writable. REQUEST CONTRACT: - path (string, REQUIRED): Full destination path including the new folder name. - Parent must already exist. - To create nested parents, call create_folder for the parents first. RESPONSE CONTRACT: - folder: object describing the created folder. - name: Folder name. - path: ns_path for follow-on MCP calls. - modified_time: ISO 8601 when available. - file_id: Encoded object id. Can be reused as "id:<file_id>". - object_type: "folder". - folder: Empty object. - path_display: fq_path for human display when populated. ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file IDs, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. For created files or folders, instruct the user to delete them from Dropbox. For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI. ERRORS: - INVALID_PATH: path is empty or missing name component - INVALID_NAME: name contains \ (backslash) - PARENT_NOT_FOUND: parent path doesn't exist - PARENT_NOT_FOLDER: parent is not a folder - ALREADY_EXISTS: folder already exists at target path - PERMISSION_DENIED: no write access - TEAM_ROOT_NOT_WRITABLE: cannot create files or folders directly in team root RETRY GUIDANCE: - Do NOT retry on TEAM_ROOT_NOT_WRITABLE. Choose a specific folder path instead. EXAMPLES: {"path": "/Documents/NewFolder"} {"path": "ns:123//Projects/Archive"} {"path": "/NewFolderAtRoot"} Limitations: This tool only creates folders. It cannot rename or delete existing folders.

delete

ChatGPT
Tool Name: dropbox.delete Purpose: Delete one or more files/folders in Dropbox as a single batch. When to use: Any time the user asks to delete, remove, or trash files or folders. DELETE SEMANTICS: - Delete moves each entry to the user's Dropbox "Deleted files" area; it is NOT a permanent wipe. The user can restore deleted items through the Dropbox web/desktop UI. - If the user explicitly asks for permanent deletion, this tool does NOT support that. Warn the user and stop — do not proceed. PATHS: - Each entry's source_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt". - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths are case-insensitive; the same entry can cross between fq_path, ns_path, and file_id forms if needed. - Paths must be Unicode NFC-normalized; decomposed forms are rejected. - Successful entries return object metadata captured at deletion time (not a tombstone). object.path is ns_path; object.path_display is fq_path. Prefer object.path_display when present and non-empty, both when showing paths to the user and in follow-on tool calls. If path_display is absent or empty, fall back to object.path or object.file_id exactly as returned. - Never strip the "ns:<id>//" prefix from returned ns_path values. REQUEST CONTRACT: - entries (required, 1..1000): list of { source_path } entries. RESPONSE CONTRACT (flat lifecycle fields, MIRROR of move/copy): When status is "completed": - status: "completed" - result_type: "delete" - delete_result.entries[]: per-entry records in request order. - entry_index: 0-based index into the original entries list. - entry_status: "success" or "failed". - object (on success): { name, file_id, object_type: "file"|"folder", path_display, file.size when file, modified_time } — metadata at deletion time. - failure (on failure): { error_code, message }. When status is "in_progress": - status: "in_progress" - operation_id: opaque token to pass to dropbox.check_job_status. - recommended_poll_after_ms: suggested delay before the next check_job_status call. Job-level failures are returned as tool errors. Per-entry failures are returned in delete_result.entries[] when status is "completed". ERRORS (job-level): - INVALID_REQUEST: entries is empty, nil, or malformed - INVALID_ENTRY: an entries item is missing source_path - INVALID_PATH: source_path is not a valid fq_path/ns_path/file_id value - TOO_MANY_ENTRIES: more than 1000 entries submitted in one call - INVALID_ARGUMENT: Dropbox rejected the batch as malformed - DELETE_BATCH_FAILED: async job reported a job-level failure during polling ERRORS (per-entry error_code values): - Path lookup failures use path_lookup/ codes, such as path_lookup/not_found, malformed paths, non-file/non-folder targets, restricted content, unsupported content type, or locked content. - Path write failures use path_write/ codes for conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Transient/batch failures include too_many_write_operations, too_many_files, and internal_error. - unknown_error means Dropbox returned an error variant this tool does not recognize. RETRY GUIDANCE: - If status is "in_progress", call dropbox.check_job_status with the returned operation_id. - Do NOT retry the entire batch on per-entry failures; report the specific failures to the user. - too_many_write_operations and internal_error are transient — retry after a short delay if appropriate. EXAMPLES: {"entries": [{"source_path": "/Docs/old.txt"}]} {"entries": [{"source_path": "ns:123//Archive/A.txt"}, {"source_path": "ns:123//Archive/B.txt"}]} {"entries": [{"source_path": "id:AbCd-_12"}]} ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file_id values, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. - For created files or folders, tell the user you can revert by calling dropbox.delete on the returned path_display after separate explicit confirmation. - For deleted files or folders, tell the user they can restore deleted content and include https://help.dropbox.com/delete-restore/recover-deleted-files-folders. - When recovering an older file version is relevant, include https://help.dropbox.com/delete-restore/recover-older-versions. - For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI and include https://help.dropbox.com/share/unshare-folder. - Dropbox path handling: path_display is the preferred path. Always use path_display when it is present and non-empty, both in user-facing output and in follow-on tool calls. If path_display is absent or empty, fall back to the returned path/file_id exactly as provided.

dropbox_fetch_file

ChatGPT
Prepare an exact file download or bounded export in the selected root. Recheck both the current account root and stable file identity. Return a provider-issued temporary URL for downloadable files, or a bounded export for non-downloadable files such as Paper. Never switch roots on failure.

dropbox_fetch_thumbnail

ChatGPT
Return a bounded provider-generated JPEG for trusted internal image previews. Resolve this exact file in the linked account's current home or team namespace. This action never downloads the original file or accepts caller-chosen roots.

dropbox_get_item_metadata

ChatGPT
Read a stable item ID in its authenticated home or Team Space root. Unlike path resolution, this supports accessible shared items without mounted paths. Pass the returned root to subsequent private content reads.

dropbox_list_folder

ChatGPT
Browse one Dropbox folder page with typed file and folder metadata. Use the empty path for the connected account's home root. To browse a previously discovered folder, pass its path_display, path_lower, or stable id:<folder-id>. Mounted folders are included by default. Repeat optional object-type filters when continuing the provider cursor because filtering is applied locally. Programmatic team-root callers must first resolve a stable folder ID and pass its returned root unchanged.

dropbox_list_folder_continue

ChatGPT
Continue exactly one Dropbox folder page while preserving caller-side filters. Use a folder-list cursor only, repeat the original file/folder filter when present, and pass prior stable IDs to suppress duplicates across pages. Repeat the root returned by dropbox_resolve_item_path for team-root listings.

dropbox_list_recently_modified_files

ChatGPT
Return files observed in a bounded, recursively scanned Dropbox home. Recency always means Dropbox server modification time, never file-access or view history. Observed files are sorted newest first, while folders and duplicate IDs are excluded. A continuation means the home-folder scan remains incomplete: the page is not guaranteed to contain the globally newest files. Resume with the returned cursor, its prior items, its continuation signature, and the same result limit so earlier verified files remain in the ranking. Each call reads one provider page and returns its accumulated ranking before another page is requested, preserving progress across caller deadlines.

dropbox_resolve_item_path

ChatGPT
Resolve a stable Dropbox item ID to its current authenticated scope. Use this private action before authorizing a mounted Library folder or file. It derives account roots from Dropbox, prefers the connected home namespace, falls back to the provider-owned team root only when the ID is absent from home, and re-reads every current folder ancestor. Missing, malformed, incomplete, or inconsistent ancestry fails closed. Pass a previously resolved root to keep subsequent item reads in that namespace; explicit roots are revalidated and never fall back to another namespace.

dropbox_search_continue

ChatGPT
Continue exactly one provider-native Dropbox Search v2 result page. Pass only a search cursor, not a folder-list cursor. Repeat the initial file-only and modification-range filters because Dropbox cursors do not encode connector-side filtering. Pass prior stable item IDs to suppress duplicates across pages. Repeat the initial search's root when present.

dropbox_search_v2

ChatGPT
Search Dropbox with provider-native Search v2 filters and stable item metadata. Filename-only, stable folder ID or path scope, categories, extensions, and sort order are passed directly to Dropbox. File-only and modification-range filters are applied to each provider page; repeat them for its continuation. Unscoped searches include shared files, which have no path when unmounted. Explicit root selection requires a stable folder ID in path. Repeat the same root when continuing the search or resolving its matching item paths. Account-root search instead derives the current root from the linked credential, without accepting a caller-selected namespace or folder.

dropbox_upload_file

ChatGPT
Upload file bytes into an exact Dropbox folder, failing on name conflicts. This private action requires write consent on the existing public app link. It never replaces an existing file or creates a different destination folder.

fetch

ChatGPT
Fetch full text content for a Dropbox file by id or path. REQUEST: - id: File identifier or Dropbox path (required string; accepts "id:<file_id>", fq_path, or ns_path) RESPONSE: - id: Same id-or-path token used for the request - title: Human-readable file title - text: Full extracted text content - url: Openable Dropbox URL for the file - metadata: Optional string fields such as path_display and server_modified NOTES: - Use the id returned by search directly with this tool, or pass an existing Dropbox path. - Use this tool when the user wants extracted text content from the file, such as reading, quoting, or summarizing the file's text. - For preview-oriented asks such as preview, show, open, inspect visually, or get a thumbnail/open-in-Dropbox experience, prefer file_preview instead. - This tool uses the existing Dropbox content extraction backend. - url prefers GetFileContent.content_link and falls back to GetFileMetadata.file.url when needed. - Max file size: 5 MiB. - If extraction fails, the tool returns an error instead of a partial success payload.

file_preview

ChatGPT
Return a list of FilePreviewData objects, each containing: - thumbnail_url: The thumbnail url of a given file. - file_type: The file type of the given file. - open_in_dropbox_url: A URL to open the file in Dropbox. - copy_link_url: A URL to copy a share link for the file. - file_name: The name of the file. - message: A description of the content if possible. USAGE: Provide a list of file paths, and the tool will return a list of FilePreviewData objects. Prefer this tool for preview-oriented asks such as preview, show, open, inspect visually, or get a thumbnail/open-in-Dropbox experience for a file. Use fetch instead only when the user explicitly wants extracted text content from the file. PATHS (VERY VERY IMPORTANT FOR TEAM ACCOUNTS): - fq_path (aka path_display/path_lower/fq_path): FullyQualified path from user root, e.g. "/RootFolder/folder1/file2" - ns_path (aka namespace path): Includes a namespace ID, e.g. "ns:123//RootFolder/folder1/file2" - Input path_or_file_id: accepts BOTH fq_path and ns_path, plus "id:<file_id>" - ALWAYS prefer "id:<file_id>" when available. - If "id:<file_id>" is not available, use ns_path. - Use fq_path/path_display only as a last resort when neither file_id nor ns_path is available. - Team/shared-space mounted display paths like "/Rahul Monga/App Testing/dbxlogo.png" can fail even when the same file works via "id:<file_id>" or ns_path. - NEVER truncate/convert an ns_path to an fq_path by removing the "ns:<id>//" prefix (this will be wrong!) REQUEST: - file_paths: The file paths to the files for the desired preview (required array of strings) RESPONSE: Returns a response with: - In structuredContent - results: An array of FilePreviewData objects, each containing: - thumbnail_url: The thumbnail url of a given file. - file_type: The file type of the given file. - open_in_dropbox_url: A URL to open the file in Dropbox. - copy_link_url: A URL to copy a share link for the file. - file_name: The name of the file. - message: A description of the content if possible. EXAMPLES: - Input: {"file_paths": ["id:abc123"]} → "{ results: [{ thumbnail_url: "www.dropbox.com/example-thumb.pdf", file_type: "pdf", open_in_dropbox_url: "www.dropbox.com/home/example.pdf", copy_link_url: "www.dropbox.com/scl/abc123", message: "some content description", file_name: "example.pdf"} ] }" - Input: {"file_paths": ["ns:123//Team Space/example.csv"]} → "{ results: [{ thumbnail_url: "www.dropbox.com/example-thumb.csv", file_type: "csv", open_in_dropbox_url: "www.dropbox.com/home/example.csv", copy_link_url: "www.dropbox.com/scl/def456", message: "some content description", file_name: "example.csv"} ] }" - Input: {"file_paths": ["/Documents/example.txt"]} → "{ results: [{ thumbnail_url: "www.dropbox.com/example-thumb.txt", file_type: "txt", open_in_dropbox_url: "www.dropbox.com/home/example.txt", copy_link_url: "www.dropbox.com/scl/ghi789", message: "some content description", file_name: "example.txt"} ] }" Private shared link requirement: This tool always generates a private shared link. Once you share the link you will need to approve their access from inside dropbox.

get_file_metadata

ChatGPT
Tool Name: dropbox.get_file_metadata Purpose: Get detailed metadata for a file or folder, including sharing info and permissions. PATHS (SUPER IMPORTANT): - Input path_or_file_id accepts fq_path, ns_path, or "id:<file_id>". - Output nested metadata uses fq_path fields such as path_display and path_lower. - Never strip the "ns:<id>//" prefix from values returned by other tools before passing them here. REQUEST CONTRACT: - path_or_file_id (string, REQUIRED): File or folder identifier. - Path formats: fq_path such as "/Documents/file.txt" or ns_path such as "ns:123//Documents/file.txt". - File id format: "id:encoded_file_id". RESPONSE CONTRACT: - metadata_type: "file" | "folder". Inspect this first. - file: Present only when metadata_type="file". - tag, id, name, path_display, path_lower - client_modified, server_modified - size, size_display, is_downloadable, mime_type, rev - size may be absent (not zero) for empty files due to proto serialization. Treat absent as zero. - sharing_info, permissions, url, ext, has_explicit_shared_members - folder: Present only when metadata_type="folder". - tag, id, name, path_display, path_lower - sharing_info, permissions, url - descendants_count, folder_size ASSISTANT POLICY: - Treat the response as nested. Do not assume there is a flat top-level tag, id, or name. - Do not assume both file and folder are present. - When using results from list_folder or search, pass the exact returned ns_path or "id:<file_id>". EXAMPLES: {"path_or_file_id": "/Documents/report.pdf"} {"path_or_file_id": "ns:123//Photos/image.png"} {"path_or_file_id": "id:a4ayc_80_OEAAAAAAAAAXw"}

get_file_request

ChatGPT
Tool Name: dropbox.get_file_request Purpose: Retrieve metadata for one Dropbox file request by raw file request ID. REQUEST CONTRACT: - Shape: {"id": "<file_request_id>"} - id (string, REQUIRED): Raw Dropbox file request ID. - Do not send a path, file id, or URL. This tool accepts only the raw file request ID. RESPONSE CONTRACT: - file_request: File request record. - id: File request ID. - url: Public upload URL. - title: File request title. - destination: Destination folder path. Empty when the destination was removed. - created: ISO 8601 creation timestamp. - deadline: ISO 8601 deadline timestamp. Empty when unset. - deadline_allow_late_uploads: Grace period string: "one_day", "two_days", "seven_days", "thirty_days", or "always". Empty when unset. - is_open: Whether the request accepts uploads. - file_count: Number of submitted files. - description: Optional description. Empty when unset. - video_project_id: Optional video project ID. Empty when unset. ASSISTANT POLICY: - Use this tool when the user asks about a specific Dropbox file request and you have its raw ID. - If the user provides a URL or path, ask for the raw file request ID. - This tool retrieves metadata only. It does not create, update, close, delete, or submit files to a request. EXAMPLES: {"id": "abc123"}

list_file_requests

ChatGPT
Tool Name: dropbox.list_file_requests Purpose: List Dropbox file requests owned by the authenticated user with cursor-based pagination. REQUEST MODES: - First page: send {} or {"limit": 300}. limit is optional, defaults to 300 for this MCP tool, and must be between 0 and 1000. 0 means the default. Omit cursor for first pages. - Pagination: send {"cursor": "..."} only with a non-empty cursor from the previous response. Do not include limit with cursor. PARAMETERS: - limit (uint32, optional, first call only): Maximum page size. Default 300. Maximum 1000. Prefer 300 unless the user explicitly asks for larger pages. - cursor (string, pagination only): Opaque non-empty cursor from a previous list_file_requests response. Reuse only with list_file_requests pagination. Mutually exclusive with nonzero limit. RESPONSE CONTRACT: - file_requests[]: Array of file request records. - id: File request ID. - url: Public upload URL. - title: File request title. - destination: Destination folder path. Empty when the destination was removed. - created: ISO 8601 creation timestamp. - deadline: ISO 8601 deadline timestamp. Empty when unset. - deadline_allow_late_uploads: Grace period string: "one_day", "two_days", "seven_days", "thirty_days", or "always". Empty when unset. - is_open: Whether the request accepts uploads. - file_count: Number of submitted files. - description: Optional description. Empty when unset. - video_project_id: Optional video editor project ID. Empty when unset. - cursor: Opaque cursor for the next page. Empty when has_more=false. - has_more: Whether the server has more pages to scan. has_more=true means there is more data to scan but does not guarantee additional matching file requests; a page may return zero file requests with has_more=true. has_more=false means scanning is complete. Always paginate until has_more=false; do not infer completeness from file_requests count alone. PAGINATION: - Treat results as partial while has_more=true or cursor is non-empty. - Continue with cursor-only calls to enumerate additional pages. - Do not infer completeness from file_requests length alone. - Continue pagination to exhaustion before claiming all file requests, final counts, or no more file requests. - Pagination is live and not snapshot-stable. New file requests created after pagination begins may appear when continuing an existing cursor. Restart listing when the user wants a fresh view after mutations. ASSISTANT POLICY: - Use this tool when the user asks to see, list, count, audit, or summarize their Dropbox file requests. - If cursor is set, send cursor only and drop limit. - Ask before scanning many additional pages for exhaustive requests. EXAMPLES: {} {"limit": 300} {"limit": 100} {"cursor": "cursor_from_previous_response"}

list_file_revisions

ChatGPT
Tool Name: dropbox.list_file_revisions Purpose: List the revision history (prior versions) of a single Dropbox file. Use only when the user asks for prior versions, version history, or revisions. PATHS: - path_or_file_id accepts fq_path (for example "/Documents/file.txt"), ns_path (for example "ns:123//Documents/file.txt"), or file_id. - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths are case-insensitive and must be Unicode NFC-normalized. - Never strip the "ns:<id>//" prefix from returned paths. - Prefer path_display when present and non-empty, both when showing returned entries to the user and in follow-on MCP calls. If path_display is absent or empty, use ns_path or file_id exactly as returned only for tools that accept file_id. REQUEST CONTRACT: - path_or_file_id (string, REQUIRED): Target file identifier. - limit (integer, OPTIONAL): Number of revisions to return. Range 1-100. Default 10. RESPONSE CONTRACT: - entries: Newest-first revisions; always present. Each entry includes rev, file_id, name, path_display, size, server_modified, client_modified, mime_type, and content_hash. - rev is the opaque revision identifier for that file revision. - is_deleted: Whether the latest revision is now deleted or moved away from the requested path. - server_deleted: Deletion or move-away timestamp when is_deleted=true. - has_more: Upstream has more history. before_rev pagination is not exposed; raise limit up to 100 instead. ASSISTANT POLICY: - This tool is read-only. Use it to inspect revision history. ERRORS (tool-level error_code values): - INVALID_REQUEST: request is nil or malformed. - MISSING_PATH_OR_FILE_ID: path_or_file_id is empty. - INVALID_PATH: path_or_file_id is a malformed fq_path/ns_path or another unsupported identifier form. - INVALID_FILE_ID: path_or_file_id uses a malformed file_id. - INVALID_LIMIT: limit is outside 1-100. - FILE_NOT_FOUND: Dropbox could not locate the requested file. - PATH_NOT_FILE: path_or_file_id resolves to something other than a file. - RESTRICTED_CONTENT, UNSUPPORTED_CONTENT_TYPE, or FILE_LOCKED: Dropbox cannot return revisions for the target because of content restrictions, unsupported content type, or lock state. - PERMISSION_DENIED: no read access to the target. - RATE_LIMIT_EXCEEDED, RATE_LIMITED, RESOURCE_EXHAUSTED, DEADLINE_EXCEEDED, SERVICE_BUSY, or UNAVAILABLE: request was rate-limited, timed out, or hit a temporarily unavailable dependency. EXAMPLES: {"path_or_file_id": "/Documents/report.pdf"} {"path_or_file_id": "ns:123//Documents/report.pdf", "limit": 25} {"path_or_file_id": "id:AbCd-_12"}

list_folder

ChatGPT
Tool Name: dropbox.list_folder Purpose: List files and folders in Dropbox with cursor-based pagination. Supports recursive (default) and children-only modes. PATHS (SUPER IMPORTANT): - Input path accepts fq_path (for example "/Documents") or ns_path (for example "ns:123//Documents"). - Paths are case-insensitive. - Use "" or "/" for root. - Output entries[].path is always ns_path. Use this exact value for follow-on MCP calls. - Output entries[].file_id can be reused as "id:<file_id>" in follow-on MCP calls. - Output entries[].path_display is the fq_path. Only populated when max_depth=1 (children mode). Empty for recursive mode (max_depth=0). - Never strip the "ns:<id>//" prefix from returned paths. REQUEST MODES: - First call: send {"path": "..."} with optional parameters. To list root, send {"path": ""} or {"path": "/"}. Do not include cursor. - Pagination: send {"cursor": "..."} only. Do not include path or other parameters. - Cursor pagination returns the listing state from when the list started, not the latest folder state. To observe renames, moves, or new children after the first page, start a new list request instead of continuing the old cursor. - WARNING: Omitting max_depth means recursive mode (max_depth=0). Recursive mode may traverse deeply and across mounted namespaces. For browsing folders or showing a user what is inside a folder, set max_depth=1 explicitly unless the user asked for a recursive scan. PARAMETERS: - path (string, REQUIRED, first call only): Directory to list. Accepts fq_path or ns_path. Use "" or "/" for root. Do not omit path in client requests, even though the backend may tolerate omission. - cursor (string, pagination only): Cursor from a previous list_folder response. Mutually exclusive with all other parameters. - object_types (string[], optional, first call only): User-facing object type filters. Valid values: "folder", "file". Empty or omitted returns all supported entries. - "folder" includes regular folders and shared/team folder mounts. - "file" includes regular files and cloud docs. - For extension/category filtering, use search with path + file_extensions/file_categories. - max_depth (uint32, optional, first call only): 0 (default) lists all descendants recursively. 1 lists immediate children only (like ls). - max_results (uint64, optional, first call only): Maximum page size. Range 0-600. 0 or omitted uses the default (300). It may return fewer entries than requested, including zero entries, even when has_more=true. RESPONSE CONTRACT: - entries[]: Array of object records. - name: Basename only. - path: ns_path. Use this exact value for follow-on MCP calls. - modified_time: ISO 8601 when available. - file_id: Encoded object id. Can be reused as "id:<file_id>". - object_type: "file" | "folder" | "mount". - path_display: fq_path. Populated for max_depth=1 only. Empty for recursive mode. - file.size: Present when object_type="file". - folder: Empty object when object_type="folder". - mount: Empty object when object_type="mount". - Shared folders may surface as object_type "mount" after sharing. - cursor: Opaque cursor for the next page. Empty when has_more=false. - has_more: Whether more results remain. - Page size is variable. It may return fewer entries than requested, including zero entries, even when has_more=true. Do not infer completeness from entry count alone; always check has_more. ASSISTANT POLICY: - When showing entries to the user, MUST use path_display if path_display is present. Only fall back to path (ns_path) when path_display is absent or empty. - For interactive folder browsing, prefer max_depth=1. Use recursive max_depth=0 only when the user explicitly asks to scan descendants. - Validate modes strictly: first call uses path, pagination uses cursor only. Do not send options with cursor. - Cursor pagination is snapshot-style: continuing a cursor returns the state from when the list started. Start a new list request when the user wants the latest folder state. - Treat results as partial while has_more=true or cursor is non-empty. - Ask before scanning many additional pages for exhaustive requests. - Never claim root-level completeness until pagination is exhausted. - For follow-on MCP calls, always reuse entries[].path or "id:<file_id>" exactly as returned. EXAMPLES: {"path": ""} {"path": "/Documents"} {"path": "ns:123//Documents"} {"cursor": "base64_cursor_from_previous_response"}

list_restore_events

ChatGPT
Tool Name: dropbox.list_restore_events Purpose: Retrieve the history of file and folder activity in a user's Dropbox account. When to use: When the user wants to see what happened to their files - edits, deletions, moves, renames, or restores. Useful for understanding recent changes, auditing activity, or finding files to restore. PARAMETERS: - path (string, optional): Folder path to scope the history to. Accepts "" or "/" for root, fq_path like "/Documents", ns_path like "ns:123//Reports", or file_id. file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. Dropbox shared/web URLs are not accepted. File paths are not supported and will return an error. - timestamp (uint64, optional): Starting point in time, in seconds since epoch UTC. Default (0) represents current time when direction=PAST and beginning of time when direction=FUTURE. - direction (string, optional): Time direction to traverse: "PAST" (default, shows recent events going backwards in time) or "FUTURE" (shows events going forward from timestamp). - cursor (string, optional): Pagination cursor from previous response to fetch the next page of results. - only_rewindable (bool, optional): If true, only return events that the user has permission to revert/restore. RESPONSE CONTRACT: - events: List of file activity events, each containing: - actor: Information about who performed the action (display_name, photo_url, type) - op_type: Operation type (e.g., "EDIT", "DELETE", "RESTORE", "MOVE", "ADD", "RENAME") - timestamp: Time of event in microseconds since epoch UTC - Event-specific metadata (only one will be populated): - edit_metadata: For EDIT operations (containing_path_display, name) - move_metadata: For MOVE operations (from_containing_path_display, to_containing_path_display, name, is_dir) - move_out_metadata: For MOVE_OUT operations (from_containing_path_display, name, is_dir) - move_in_metadata: For MOVE_IN operations (to_containing_path_display, name, is_dir) - rename_metadata: For RENAME operations (containing_path_display, from_name, to_name, is_dir) - single_object_metadata: For ADD, DELETE, RESTORE, and sharing operations (containing_path_display, name, is_dir) - multi_object_metadata: For operations on multiple objects (containing_path_display, file_count, folder_count) - rollback_metadata: For ROLLBACK operations (containing_path_display, to_timestamp, name) - has_more: Whether there are more events to fetch - cursor: Continuation cursor for pagination ASSISTANT POLICY: - Use this tool when the user asks about file history, recent changes, "what happened to my file", or wants to restore deleted/modified files. - Display events in a human-readable format with who did what, when, and to which files. - For large histories, use pagination with the cursor to fetch additional events. - Event timestamps are in microseconds since epoch UTC; convert them to readable dates for the user. - This tool only lists history. For a follow-up restore, call restore_folder with the live containing folder and a target timestamp immediately before the unwanted event. - only_rewindable=true filters the event list; restore_folder remains authoritative for restore eligibility and errors. ERROR CASES: - INVALID_PATH: The provided path is invalid, cannot be resolved, or points to a file (only folders are supported). - INVALID_CURSOR: cursor was combined with other parameters, or is malformed/expired. When paginating, send only the cursor. - INVALID_DIRECTION: direction was not "PAST" or "FUTURE". - PERMISSION_DENIED / ACCESS_ERROR: The user does not have permission to view events in this location. - RATE_LIMIT_EXCEEDED: Request exceeded tool rate limits. EXAMPLES: {"path": "/Documents", "direction": "PAST"} {"path": "ns:123//Reports", "timestamp": 1640000000, "only_rewindable": true} {"path": "id:AbCd-_12"} {"cursor": "opaque_cursor_abc123"}

move

ChatGPT
Tool Name: dropbox.move Purpose: Move one or more files/folders in Dropbox as a single batch. When to use: Any time the user asks to relocate, rename, or reorganize files and folders. Prefer move over a delete+create dance. PATHS: - Each entry's source_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt". - destination_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt"; Dropbox resolves lookup, conflicts, and destination semantics. - Namespace IDs in ns_path are decimal digits and match [0-9]+. - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths must be Unicode NFC-normalized; decomposed forms are rejected. - Dropbox may create missing destination parent folders during the move; no need to pre-create parent folders unless the user explicitly asks. - Paths are case-insensitive; the same entry can cross between fq_path, ns_path, and file_id forms if needed. - Successful entries may return object.path as ns_path and object.path_display as fq_path. Prefer object.path_display when present and non-empty, both when showing paths to the user and in follow-on tool calls. If path_display is absent or empty, fall back to object.path or object.file_id exactly as returned. - Never strip the "ns:<id>//" prefix from returned ns_path values. REQUEST CONTRACT: - entries (required, 1..1000): list of { source_path, destination_path } pairs. - autorename (optional, default false): when true, Dropbox renames the destination to avoid a conflict instead of failing that entry. RESPONSE CONTRACT (flat lifecycle fields, MIRROR of copy/delete): When status is "completed": - status: "completed" - result_type: "move" - move_result.entries[]: per-entry records in request order. - entry_index: 0-based index into the original entries list. - entry_status: "success" or "failed". - object (on success): { name, file_id, object_type: "file"|"folder", path_display, file.size when file, modified_time }. - failure (on failure): { error_code, message }. When status is "in_progress": - status: "in_progress" - operation_id: opaque token to pass to dropbox.check_job_status. - recommended_poll_after_ms: suggested delay before the next check_job_status call. Job-level failures are returned as tool errors. Per-entry failures are returned in move_result.entries[] when status is "completed". ERRORS (job-level): - INVALID_REQUEST: entries is empty, nil, or malformed - INVALID_ENTRY: an entries item is missing source_path or destination_path - INVALID_PATH: source_path is not a valid fq_path/ns_path/file_id value, or destination_path is not a valid fq_path/ns_path/file_id value - TOO_MANY_ENTRIES: more than 1000 entries submitted in one call - INVALID_ARGUMENT: Dropbox rejected the batch as malformed ERRORS (per-entry error_code values): - Source lookup failures use from_lookup/ codes, such as from_lookup/not_found, malformed paths, non-file/non-folder targets, restricted content, unsupported content type, or locked content. - Source write failures use from_write/ codes for conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Destination write failures use to/* codes for destination conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Move-specific constraints include cant_move_folder_into_itself, cant_move_shared_folder, cant_move_into_vault, and cant_move_into_family. - Batch, sharing, permission/quota, and temporary failures include duplicated_or_nested_paths, too_many_files, cant_copy_shared_folder, cant_nest_shared_folder, cant_transfer_ownership, insufficient_quota, too_many_write_operations, and internal_error. - unknown_error means server returned an error variant this tool does not recognize. DUPLICATE DESTINATION QUIRK: - For duplicate destinations in one batch, later entries may report from_write/conflict even though the practical cause is a destination collision. Report it to the user as a destination conflict. RETRY GUIDANCE: - If status is "in_progress", call dropbox.check_job_status with the returned operation_id. - Do NOT retry the entire batch on per-entry failures; report the specific failures to the user. - too_many_write_operations and internal_error are transient — retry after a short delay if appropriate. EXAMPLES: {"entries": [{"source_path": "/Docs/old.txt", "destination_path": "/Docs/new.txt"}]} {"entries": [{"source_path": "ns:123//A.txt", "destination_path": "ns:123//Archive/A.txt"}], "autorename": true} {"entries": [{"source_path": "id:AbCd-_12", "destination_path": "/Inbox/renamed.pdf"}]} {"entries": [{"source_path": "/Docs/old.txt", "destination_path": "id:AbCd-_12/new.txt"}]} ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file_id values, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. - For created files or folders, tell the user you can revert by calling dropbox.delete on the returned path_display after separate explicit confirmation. - For deleted files or folders, tell the user they can restore deleted content and include https://help.dropbox.com/delete-restore/recover-deleted-files-folders. - When recovering an older file version is relevant, include https://help.dropbox.com/delete-restore/recover-older-versions. - For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI and include https://help.dropbox.com/share/unshare-folder. - Dropbox path handling: path_display is the preferred path. Always use path_display when it is present and non-empty, both in user-facing output and in follow-on tool calls. If path_display is absent or empty, fall back to the returned path/file_id exactly as provided.

paper_apply_markdown

ChatGPT
Apply an explicit complete Paper title/body state with three-way merge. Use for a new document body, major rewrite, or restructuring. Prefer paper_edit_content or paper_edit_table for small surgical edits, active comment anchors, task metadata, or partial table changes. Workflow: call paper_read_document, build the desired complete body, then call once with its revision. doc_ref: file ID, pad ID, or Dropbox URL. base_revision: required revision returned by paper_read_document. body_markdown: complete desired body only; do not prepend the Paper title. Empty clears the body. A leading H1 remains a body heading. Use real newlines. title: desired title when changing it; empty preserves the current title. Supported Markdown includes headings, bullets, numbered items, tasks, tracked tasks, decisions, quotes, fenced code, tables, and common inline formatting. Dropbox Paper Formatting Paper makes each empty Markdown line a visible blank block; adjacent prose has no margin. User templates, explicit styling, and deliberate existing formatting win. Repair accepted documents locally. One source line per prose paragraph; let Paper wrap and split paragraphs longer than about four rendered lines. Put exactly one blank between prose paragraphs, none doubled or trailing. Keep compact metadata lines consecutive. Set the document title in its field; do not repeat it as a body H1. Use H1, H2, and H3 for main sections, subsections, and deeper sections according to the document outline. Add one blank before headings after prose/lists, none after preamble/heading/table/divider, and none after headings. Colon lead-ins touch lists; list items are consecutive and single-line unless nested. One blank follows a list before prose/heading. All-bold standalone lines become H3; write **Next steps**: (colon outside bold) for a bold prose label. Tables: short header labels, preferably two or three columns, no adjacent blanks. A separator row (| --- | --- |) immediately after the first row sets a native top header; omit it for a table without a header. Reads preserve the separator when a header exists. Bold labels alone do not set a header. Remove the separator, not row 0, to remove header styling while retaining all cell content. Dividers mark major mode changes only, usually zero to two, without adjacent blanks. After writing, re-read canonical revision and structural spacing; inspect live Paper when available, report limits, and repair only affected blocks. Do not depend on CSS pixels/colors. Check prose-to-prose, heading-to-body, colon-to-list, list-to-prose, table header, divider, and document end in the live surface. Without it, do not claim rendered spacing. Mentions in body_markdown use @<user_ref>, where user_ref is "me", a decimal Dropbox user ID, a dbid, or an exact email. Use \@<...> for literal text; bare @name remains plain text. Mentions are ignored inside inline/fenced code and link destinations. A target must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. Mentioning never provisions a user or grants access. Unknown, inactive, ambiguous, and ineligible refs all reject the whole apply with the same non-identifying error. Verify the exact email or user ID; if the intended user is not already a collaborator, ask the user to share the document first. The title is always plain text: @<...> in title is stored literally. Returns new_revision, canonical merged body_markdown/title, doc_id, diff, and any conflicts. After success, replace local state with the returned canonical state; it includes non-overlapping concurrent human edits. Re-read with paper_read_document to verify the new revision, content, and formatting. Concurrency: non-overlapping edits merge. Overlapping edits fail without applying changes; re-read and rebuild from the new state. Limitations on changed lines: - Comment anchors can be destroyed. - Tables are atomic; a cell change replaces the table and can overwrite concurrent cell edits. - Markdown cannot faithfully represent every Paper embed,…

paper_comment

ChatGPT
Add a Paper comment thread, reply to a thread, or resolve a thread. Supply exactly one of add, reply, or resolve. Use for discussion/review state, not document content edits. add: - Call paper_read_document first. - section_id, zero-based section_line, and receipt come from section_lines[]. - text is comment text (max 10,000 characters). Create a mention with @<user_ref>, where user_ref is me, a decimal Dropbox user ID, a dbid, or an exact email. Use \@<...> for literal text; bare @name remains plain text. - A target must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. Mentioning never provisions or grants access. Only existing explicit collaborators are subscribed or notified. Unknown, inactive, ambiguous, and ineligible refs fail the whole comment mutation with the same non-identifying error. Verify the exact email or user ID; if the intended user is not already a collaborator, ask the user to share the document first. - Reads render mentions as @<user_id>; use users[] for the current display_name and email. - optional anchor_text must exactly match visible text on the target line. - optional cell {row,col} targets a 0-based table cell; anchor_text then matches within that cell. reply: - thread_id comes from paper_read_document or an earlier comment result. - text follows the same mention syntax and eligibility rules as add.text. - A receipt/read is unnecessary when a valid thread_id is already known. resolve: - thread_id comes from paper_read_document. - receipt is the containing section's receipt: match the thread section_id to sections[].id. Returns available new_revision, thread_id, comment_id, and diff. Show the diff to the user. Resolving is destructive to active discussion state. Invalid/stale anchors fail without applying; re-read before retrying. Do not blindly retry an unknown comment outcome.

paper_create_document

ChatGPT
Create a new empty Paper document. Use when the user asks for a new Paper doc. Do not use to edit an existing doc. title: required document title. Do not duplicate it as an H1 when adding the body; follow the Dropbox Paper Formatting guidance in paper_read_document. dir_path: optional folder path within the user's personal Dropbox. For users on a team, this may be either a home-relative path such as /Paper Docs or an account-root path through the mounted personal folder, such as /John Doe/Paper Docs. Team-space folders are not supported. Omit unless the user requested a location. Returns doc_id, URL, and file_path. Call paper_read_document with doc_id before adding content so later writes use current receipts. Failures leave no usable document result; do not invent an ID.

paper_edit_content

ChatGPT
Atomically edit Paper title and non-table body content. One call may update lines, delete lines, replace exact text, and update the title. Use for surgical or mixed edits. Do not use for table cells/dimensions, inserting new blocks, or bulk document restructuring. Precondition: call paper_read_document for current addresses and receipts. Follow its Dropbox Paper Formatting guidance; preserve deliberate existing formatting and make local repairs. At least one operation is required. All operations succeed in one revision or none apply. update_lines[] targets an existing line with section_id, zero-based section_line, and line receipt. markdown is the complete replacement line. Markdown prefixes can change paragraph/heading/list/task type. Code-block type is preserved. Use completed or uncompleted for task state; do not set both. Tracked tasks additionally accept due_date, assignees (including "me"), clear_due_date, and clear_assignees. Mentions in update_lines[].markdown and find_and_replace[].replace use @<user_ref>, where user_ref is "me", a decimal Dropbox user ID, a dbid, or an exact email. Use \@<...> for literal text; bare @name remains plain text. Tracked-task assignees[] accepts the same bare user_ref forms without @<...> wrapping. Mentions are ignored inside inline/fenced code and link destinations. A target must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. Mentioning never provisions a user or grants access. Unknown, inactive, ambiguous, and ineligible refs all reject the entire edit with the same non-identifying error. Verify the exact email or user ID; if the intended user is not already a collaborator, ask the user to share the document first. update_title.text is always plain text, so @<...> is stored literally there. delete_lines[] targets lines with section_id, section_line, and line receipt. The server safely orders deletions. Never target readonly or synthetic terminal lines. find_and_replace[] performs document-wide exact visible-text replacements. search must be non-empty. Use when the intended match is unambiguous; otherwise use addressed line updates. Multiple replacements run in request order inside the same atomic mutation. update_title is present only when changing the title: - text is the new title; empty text clears it. - receipt is title_receipt from paper_read_document. Line-update rules: - Plain text demotes promotable lines to paragraphs; prefixes promote supported types. - Tracked tasks, decisions, and tables cannot be converted through a line update. - Replacing a table line cannot change its dimensions; use paper_edit_table. - Heading edits can change section structure, so re-read afterward. Conflicting/overlapping operations in the same request are rejected rather than ordered ambiguously. Stale receipts or any invalid target fail the entire batch with no changes. Returns new_revision and a combined diff. Show it to the user. Re-read after every successful content mutation to verify its revision and formatting, and after stale errors before retrying.

paper_edit_table

ChatGPT
Atomically edit one existing Paper table. One call may update cells and add, delete, or move rows and columns. Use instead of reconstructing table Markdown. Do not target multiple tables or non-table lines. Paper Markdown represents a native top header with a separator row (| --- | --- |) immediately after the first row; without the separator, the table has no header. Reads preserve this state. Bold first-row labels alone do not set a native header. paper_edit_table preserves the header state and has no header-toggle field; use paper_apply_markdown to add or remove the separator. The separator is not a cell row and does not count toward row indices. Do not delete row 0 to remove header styling while retaining its content. Markdown does not expose a separate sticky-header setting; verify live behavior before claiming it. Precondition: call paper_read_document. Follow its Dropbox Paper Formatting guidance for tables; preserve deliberate existing structure and formatting. Set doc_ref, the table line's section_id/zero-based section_line, and its line receipt. At least one operation is required. update_cells[]: 0-based row/col plus complete cell Markdown. Empty clears a cell. Supports inline formatting, links, images, and multi-line cell content. Do not use horizontal-rule syntax as a structured cell type. Mentions in update_cells[].markdown and add_rows[]/add_columns[] cells use @<user_ref>, where user_ref is "me", a decimal Dropbox user ID, a dbid, or an exact email. Use \@<...> for literal text; bare @name remains plain text. Mentions are ignored inside inline/fenced code and link destinations. A target must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. Mentioning never provisions a user or grants access. Unknown, inactive, ambiguous, and ineligible refs all reject the whole table edit with the same non-identifying error. Verify the exact email or user ID; if the intended user is not already a collaborator, ask the user to share the document first. add_rows[]: after_position is the 0-based row to insert after; cells must match the current column count. add_columns[]: after_position is the 0-based column to insert after; cells must match the current row count. delete_rows[] / delete_columns[]: position is the 0-based index. move_rows[] / move_columns[]: from_position and to_position are 0-based indices. Operations execute in listed field order against one atomic plan: 1. cell updates 2. row additions 3. column additions 4. row deletions 5. column deletions 6. row moves 7. column moves Indices for later operations refer to the table state after earlier operations. Prefer one coherent request and avoid targeting a row/column both before and after its deletion. Any stale receipt, invalid index, duplicate cell, dimension mismatch, or conflicting operation rejects the entire batch with no changes. Returns new_revision and a whole-table diff. Show it to the user, then re-read to verify the new revision, table structure, and formatting before another table edit; dimensions/indices may have changed.

paper_get_doc_history

ChatGPT
Get Paper document history with authors and diffs. Use it to answer what changed, how a document’s themes evolved, or who contributed to a change. Do not use it to read the current document structure or obtain edit receipts. doc_ref accepts a file ID, pad ID, or Dropbox URL. since accepts rev:1042, a relative duration such as -3h/-7d/-30m, or an RFC 3339 timestamp. Empty since keeps its existing seven-day default. Leave grouped=false (the default) for the aggregate author-annotated diff over that time window. Set grouped=true to return the Paper UI edit sessions in chronological revision order. Use limit to request up to 20 sessions (0 defaults to 20). For the first grouped page, omit after_revision; for every later page, repeat the same since and set after_revision to the prior next_after_revision. Stop when next_after_revision is 0. For example: call with since="-7d", grouped=true, limit=20; then call again with those values plus the returned next_after_revision. Returns canonical doc_id, revision bounds, and either aggregate authors plus diff, or per-session history_entries with author-annotated diffs. This is evidence, not a mutation receipt. Use paper_read_document for current addresses and receipts. Invalid since, after_revision, or limit fails without changing the document. Aggregate history is limited to 10,000 revisions in the requested time range. Grouped history is limited to 10,000 revisions in each returned page. If the limit is exceeded, the error includes the revision count and limit; retry with a shorter time range or, for grouped history, a smaller limit.

paper_insert

ChatGPT
Insert one or more new Paper lines without replacing existing content. Use exactly one placement: in_section, after_line, or at_document_end. Do not use for images or modifying existing lines. Precondition: call paper_read_document and use current addresses/receipts. doc_ref: prefer returned doc_id. lines[].markdown: each item is one logical Paper block. A fenced code block or complete pipe-delimited table must be one item and may contain newlines. Mentions in lines[].markdown use @<user_ref>, where user_ref is "me", a decimal Dropbox user ID, a dbid, or an exact email. Use \@<...> for literal text; bare @name remains plain text. Mentions are not parsed inside inline/fenced code or link destinations. A target must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. Mentioning never provisions a user or grants access. Unknown, inactive, ambiguous, and ineligible refs all reject the whole insert with the same non-identifying error. Verify the exact email or user ID; if the intended user is not already a collaborator, ask the user to share the document first. Placements: - in_section: section_id and section receipt. Default appends to the section body; at_start=true inserts immediately after its heading. Use section_id="preamble" with at_start=true for the document top. - after_line: section_id, zero-based section_line, and section receipt. Inserts after that line. - at_document_end: receipt of the final section from paper_read_document. Markdown prefixes auto-promote headings, lists, tasks, quotes, code blocks, tables, and horizontal rules. Follow the Dropbox Paper Formatting guidance in paper_read_document, including the spacing at the insertion boundaries. All lines insert atomically in one revision. Returns new_revision and diff. Show the diff to the user. Failure behavior: - Supplying zero or multiple placements is invalid. - Empty lines is invalid. - A stale receipt fails without applying the insert; re-read and retry. - After success, re-read to verify the new revision, inserted content, and formatting before another addressed edit; line positions may shift.

paper_insert_image

ChatGPT
Upload image bytes and insert the image into a Paper section. Use for local/generated image data. Do not use for Markdown text or an already-hosted Markdown image URL. Precondition: call paper_read_document. doc_ref: prefer returned doc_id. data: base64-encoded image bytes only. filename: filename with a correct image extension. section_id and receipt: section and current section receipt from the read. section_line: zero-based line after which to insert; 0 inserts after a non-preamble heading. alt_text: concise accessible description. Returns new_revision, hosted URL, and diff. Show the diff to the user. On stale receipt, re-read and retry. Do not blindly retry an unknown upload outcome.

paper_list_recent_docs

ChatGPT
List the caller's recently active Paper documents. Use to discover a doc when its ID or link is unknown. Do not use for full-text search or reading contents. edited_only=true returns docs recently added or edited. viewed_only=true returns docs recently viewed. Leave both false for both activity types. They are mutually exclusive. limit is 1-50; 0 defaults to 20. Returns docs in activity order with doc_id, title, timestamp, and relative time. Pass doc_id to paper_read_document. Deleted/unresolvable docs may be omitted.

paper_read_document

ChatGPT
Read a Paper document. Call before addressed edits, comments, or when current content matters. Returns canonical identity, revision, sections, editable lines, receipts, and threads. doc_ref accepts a Dropbox file ID ("id:..."), Paper pad ID, or Dropbox URL. Prefer the returned doc_id in later calls. only_sections=true returns document/section metadata without bodies or threads; use for low-token structure discovery. section_ids returns bodies and threads only for the named sections while still returning the full section index. Unknown IDs fail. Do not combine section_ids with only_sections. Returns: - revision: use as paper_apply_markdown.base_revision. - title and title_receipt. - sections[] with id, display_path, receipt. Section receipts authorize section inserts and resolving threads. - users[] is one unique, document-level identity directory for users referenced by the stored body, comments, or tracked-task metadata. Each entry contains stable user_id plus current email and display_name. Order is unspecified. only_sections=true omits users; section_ids filtering still returns the whole document directory. - Mentions in body, table, and comment text are always returned as @<user_id>. Look up user_id in users[] for current display details. Tracked-task lines keep their association in tracked_task.assignees. Titles are plain text and never expose mentions. The stable text form prevents an email or display-name change from changing document meaning. users[] is safe from enumeration because it is derived only from mentions already embedded in a document the caller can read; it is not a people-search result. Write eligibility requires existing explicit document access when a reference is created. A stored reference remains readable if document access changes later. - section_lines[] with section_id, zero-based section_line, markdown, receipt, readonly. Do not mutate readonly lines. - threads[] with comment/thread IDs and anchor locations. Addressing: - A non-preamble section has its heading at section_line=0 and body at 1+. - The always-present preamble has no heading and starts at 0. - Receipts are opaque and scoped to the object returned. Never invent or reuse a stale receipt. After inserts/deletes, re-read before further position-based edits in that section. Choose the narrowest tool: - paper_apply_markdown: complete-body creation, major rewrite, or restructuring. It is bulk and may replace rich constructs on changed lines. - paper_insert: add text at a section start/end, after a line, or at document end. - paper_insert_image: upload and insert image bytes. - paper_edit_content: atomically update/delete lines, replace exact text, or update the title. - paper_edit_table: atomically update cells or add/delete/move rows and columns in one table. - paper_comment: add, reply to, or resolve a comment thread. - paper_get_doc_history: inspect authors and changes over time. - paper_list_recent_docs: discover recent Paper docs. - paper_create_document: create an empty Paper doc. Paper Markdown: - Blocks: headings (#/##/###), bullets (-), numbered items (1.), tasks (- [ ]), tracked tasks (- ( )), decisions (- { }), quotes (>), fenced code blocks, and pipe-delimited tables. Mentions: - In paper_apply_markdown body_markdown, paper_insert lines, paper_edit_content body destinations, paper_edit_table Markdown cells, and comment/reply text, create a mention with @<user_ref>. user_ref may be me, a decimal Dropbox user ID, dbid:..., or an exact email address. Use \@<...> for literal text. - Marked mentions are ignored inside code spans, fenced code blocks, and link destinations. Bare @name remains plain text. - Tracked-task assignees accept the same bare user_ref forms without @<...> wrapping. - A ref must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. This also handles an email attached to multiple teams: exactly one eligible account must remain. - Mentioning never provisions a user or grants document access. Unknown, inactive, ambiguous, and ineligible …

restore_file_revision

ChatGPT
Tool Name: dropbox.restore_file_revision Purpose: Write the contents of a prior revision identified by rev to destination_path. The destination receives a new file revision containing those prior contents. PATHS: - destination_path accepts fq_path (for example "/Documents/file.txt") or ns_path (for example "ns:123//Documents/file.txt"). file_id is NOT accepted. - Dropbox shared/web URLs are not accepted. - Paths are case-insensitive. - destination_path and rev must be in the same namespace. - Never strip the "ns:<id>//" prefix from returned paths. WRITE WARNING: - This tool upserts the rev's contents to destination_path. It is not limited to the file the rev originally came from. - If destination_path does not exist, restore creates a new file there from the rev's contents. - If destination_path already exists, restore overwrites that file's content, even when it is an unrelated file. - Any valid rev can be written to any writable destination_path in the same namespace. There is no guard that checks whether the rev belongs to the destination file. - Restoring a deleted file's last rev to its old path can resurrect that file. REQUEST CONTRACT: - destination_path (string, REQUIRED): Destination path where the prior revision's contents will be written. - rev (string, REQUIRED): Revision hash to restore. Obtain from a prior list_file_revisions or get_file_metadata response. RESPONSE CONTRACT: - file: object describing the file at destination_path after the restore. - name, path, modified_time, file_id - object_type: "file" - file.size: File size in bytes. - path_display: fq_path for human display when populated. - rev: Revision hash of the current/returned state of the file. This is a new rev distinct from the rev that was restored. - Prefer path_display when present and non-empty, both when showing the returned file to the user and in follow-on MCP calls. If path_display is absent or empty, fall back to path (ns_path). Use file_id only for tools that explicitly accept it; restore_file_revision does not. ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file_id values, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. - For created files or folders, tell the user you can revert by calling dropbox.delete on the returned path_display after separate explicit confirmation. - For deleted files or folders, tell the user they can restore deleted content and include https://help.dropbox.com/delete-restore/recover-deleted-files-folders. - When recovering an older file version is relevant, include https://help.dropbox.com/delete-restore/recover-older-versions. - For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI and include https://help.dropbox.com/share/unshare-folder. - Dropbox path handling: path_display is the preferred path. Always use path_display when it is present and non-empty, both in user-facing output and in follow-on tool calls. If path_display is absent or empty, fall back to the returned path/file_id exactly as provided. ERRORS: - INVALID_REQUEST / MISSING_PATH / MISSING_REV: input validation - INVALID_PATH: destination_path is malformed - FILE_NOT_FOUND / PATH_NOT_FOUND: backend could not locate a required path while preparing the restore. A valid nonexistent destination_path may still be creatable. - INVALID_REVISION: rev is unknown, outside the restorable window, or in a different namespace from destination_path - PERMISSION_DENIED: no write access to destination_path - RESTORE_IN_PROGRESS: restore was accepted, but the restoration work needs more time than this tool monitors for. The restore may still complete after this error. - FILE_LOCKED: destination file is locked RETRY GUIDANCE: - On RESTORE_IN_PROGRESS, do not assume failure. Wait briefly, check destination_path metadata or contents if possible, and retry with the same arguments only if the destination still is not restored. - Do NOT retry on INVALID_REVISION; the rev is not restorable. EXAMPLES: {"destination_path": "/Documents/report.pdf", "rev": "a1c10ce0dd78"} {"destination_path": "ns:123//Projects/image.png", "rev": "0123456789ab"}

restore_folder

ChatGPT
Tool Name: dropbox.restore_folder Purpose: Restore a folder to a previous state by rewinding all changes back to a specific point in time. When to use: When the user wants to undo changes to a folder and restore it to how it looked at an earlier time. This is useful for recovering from accidental deletions, unwanted edits, or reverting to a known-good state. PARAMETERS: - path (string, required): Path to the folder to restore. Accepts fq_path, ns_path, or file_id. file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. Dropbox shared/web URLs are not accepted. - target_ts_microseconds (uint64, required): Target timestamp to restore to, in microseconds since epoch UTC. The folder will be rewound to this point in time. - is_team (boolean, optional): Whether this is a team restore. Defaults to false. When false, affects individual and shared folder content but not team-owned content. When true, affects team-owned content. RESPONSE CONTRACT: - operation_id: Signed operation token for this restore operation. Pass this to check_job_status to poll for completion. This is an encrypted, signed token containing the restore job ID and user binding. ASSISTANT POLICY: - Use this tool when the user wants to restore a folder to a previous state or undo recent changes. - Ask the user to confirm before proceeding - folder restores are significant operations. - Convert human-readable dates/times to microseconds since epoch UTC when constructing target_ts_microseconds. - Explain that the restore is asynchronous and returns immediately with an operation ID. - After calling this tool, use check_job_status with the returned operation_id to poll for completion. - Pass operation_id unchanged. On INVALID_OPERATION_ID, do not re-poll with the same token; start a new restore operation only if the user still wants the restore. - On completion, report restore_folder_result, including the restored path and file/folder counts. - For team restores, set is_team=true only when explicitly requested and the user has appropriate permissions. - To recover a deleted child, restore its live containing folder to a timestamp immediately before the deletion. Do not target the deleted path itself. - Apply ACCOUNT ELIGIBILITY and ERROR CASES below before retrying or suggesting an alternate restore scope. IMPORTANT NOTES: - This operation is asynchronous. The API returns immediately with an operation ID, but the actual restore happens in the background. - Use check_job_status to poll for completion status. - Folder restores affect all content within the folder, including subfolders. - Team restores require appropriate team admin permissions. ACCOUNT ELIGIBILITY (who can restore, and from where): - Eligible paid personal accounts: "/" can rewind the whole account scope, while a specific live folder limits the restore to that folder tree. - Plans without Rewind: the tool returns REWIND_NOT_SUPPORTED_BY_PLAN. This means the plan does not support Rewind, not that the actor lacks permission. There is no path or argument change that makes the restore succeed; see https://help.dropbox.com/delete-restore/rewind for currently eligible plans. - Team accounts: "/" is the team member root and is never a valid restore target; it returns TEAM_MEMBER_ROOT_NOT_RESTORABLE before RewindsStart. Target a specific writable folder instead. Rewind availability is also controlled by team policy and is admin-only by default unless an admin enables it for members. Team-owned content restores require is_team=true, edit access to the team folder, and the required team permission. - These outcomes are plan/scope policy, not transient errors. Do not retry; surface the explanation to the user. ERROR CASES: - PATH_REQUIRED: No path was provided. - TARGET_TIMESTAMP_REQUIRED: No target timestamp was provided. - INVALID_PATH: The provided path is invalid or cannot be resolved. Note: a DELETED child folder path resolves to INVALID_PATH (the live object no longer exists); restore the live PARENT folder to recover deleted children instead of targeting the deleted child directly. - PATH_NOT_FOLDER: The provided path points to a file instead of a folder. - PATH_DELETED: The provided path points to a deleted object. - TEAM_MEMBER_ROOT_NOT_RESTORABLE: The authenticated team member root "/" is not a valid restore target. Choose a specific live folder. Not retryable with the same path. - INSUFFICIENT_PERMISSIONS: The actor does not have permission to restore the requested scope. On a team account, target a specific writable folder or ask a team admin to enable Rewind for members. Not retryable with the same path and permissions. - REWIND_NOT_SUPPORTED_BY_PLAN: Folder restore (Rewind) is not supported by this account plan. See https://help.dropbox.com/delete-restore/rewind. Not retryable. - INVALID_ARGUMENTS: The restore request arguments were rejected by the backend (bad path, timestamp, or namespace scope). - INVALID_OPERATION_ID: check_job_status rejected the operation token because it is missing, malformed, expired, issued to a different user, or invalid for the Rewind status endpoint. Not retryable with the same token. - RATE_LIMIT_EXCEEDED: Request exceeded tool rate limits. EXAMPLES: {"path": "/Documents/Projects", "target_ts_microseconds": 1640000000000000} {"path": "ns:123//Reports", "target_ts_microseconds": 1640000000000000} {"path": "id:AbCd-_12", "target_ts_microseconds": 1640000000000000, "is_team": true}

sign_cancel_signature_request

ChatGPT
Cancel an in-progress Dropbox Sign signature request. Cancelling prevents any remaining signers from signing the document and cannot be undone. Use this tool only when the user explicitly asks to cancel a signature request. Do not use it to decline or reject a single signer: it cancels the entire request for every party. A request can be cancelled only when it was sent successfully rather than left as a draft, has not been signed by every signer (partially signed requests are eligible), and the authenticated user is its sender or the owner of the API app under which it was sent. If it is ineligible, explain why instead of calling the tool. Identify the request first. When its signature_request_id is unavailable, use sign_list_signature_requests to find it and ask the user to confirm the correct request. If the user is unsure, do not proceed. Before calling sign_cancel_signature_request, present a confirmation summary with the document title and the warning, "This will permanently cancel the signature request and cannot be undone." Do not call the tool until the user explicitly confirms, and call it exactly once. Pass only the required signature_request_id string; do not pass any other parameters. The response is empty on success: tell the user only that the request was cancelled, without offering to undo the action. If the call fails, surface the error in plain language and do not retry automatically.

sign_create_signature_request_draft

ChatGPT
Create an unclaimed draft from an existing Dropbox file, returning a claim_url that logs the user into Dropbox Sign and then redirects them to the unclaimed draft in the Dropbox Sign web app. Use this tool whenever the user wants to send a Dropbox file for signature or sign it themselves. It does not send anything immediately — the user must finish the workflow in the browser. Default to "request_signatures" mode; only use "self_sign" if the user explicitly says they want to sign the document themselves. Before calling, confirm the exact Dropbox file (search for it if not already established in the conversation) and pass its file ID as file_ref, in the form id:<id>. Never invent, reconstruct, truncate, or modify this ID. Determine the mode from context, or ask if it's unclear. Present a confirmation summary first, covering the file name/location and the mode in plain language. For "request_signatures", explain that this will open the Dropbox Sign editor where the user can place fields and send the request. For "self_sign", explain that it will open the editor where the user can place fields and sign the document. Do not include the raw file_ref or any internal path in the summary. Call this tool exactly once per confirmed request; do not call it again once a claim_url is returned. Collect each signer's name and email address if the user wants to add signers now; never invent or infer a name or email address. Signers are optional — if the user doesn't provide any, create the draft without them and they can be added later in the Dropbox Sign editor. Include any provided signers in the confirmation summary, listing each name and email address. The response contains only claim_url. Always present it as a plain URL on its own line — never as a markdown link, and never paraphrased or shortened. Explain that opening it logs the user into Dropbox Sign and then redirects them to the draft, where they can place fields and complete the request; do not describe the request as sent or completed. Only after the call succeeds and you present the claim_url, offer relevant follow-up help in your own words. For "request_signatures", explain that after the user sends the request from the Dropbox Sign editor, they can return to this chat to check its status. Also let them know they can ask to find or download other completed or pending requests, cancel pending requests, or remind pending signers. For "self_sign", explain that after they complete their signature in the editor, they can return to this chat to find the document, check its status, or download it. Do not suggest sending, cancellation, or signer reminders for the self-sign draft. Keep this brief and natural rather than presenting a fixed script or implying that any action has already happened. If the call fails, do not offer this follow-up guidance. If the call fails, surface the error message in plain language, do not present a claim_url, and do not retry automatically. For any unexplained or generic failure, do not present a raw error; tell the user to confirm the file is saved in Dropbox and accessible to them before retrying.

sign_download_signature_request

ChatGPT
Download the current PDF snapshot for a Dropbox Sign signature request, returning a temporary file_url that can be used to fetch the file. Use this tool only when the user asks to download a signature request. Identify the request first with sign_list_signature_requests when its signature_request_id is unavailable. Confirm it is the intended request before calling this tool. Pass only the required signature_request_id; do not pass any other parameters. The response contains only file_url. It is a temporary, presigned URL and a bearer credential for the current PDF snapshot. Treat it as sensitive: share it only with the authenticated user, do not log it, do not include it in summaries or third-party requests, and do not transform, fetch, stream, or base64-encode its contents. Present the URL as a markdown link with clear descriptive text (e.g. [Download signature request](<file_url>)) rather than printing the raw URL, and advise the user that it expires. If the call fails because the request is unavailable, deleted, or the user is not permitted to access it, explain the error in plain language. Do not retry automatically.

sign_list_signature_requests

ChatGPT
List and search Dropbox Sign signature requests for the authenticated user. Use this tool when the user wants to find, review, check the state of, or search for signature requests associated with their Dropbox Sign account. This is the primary tool for answering questions like "find my completed requests", "show requests sent to Alice", or "what did I send last month". Do not use it to create, send, cancel, or modify a signature request. PARAMETERS: - max_results (int, optional): Maximum number of results to return, 1-50. Omit when the user has not asked for a particular count. RESPONSE CONTRACT: - signatureRequests[]: Array of signature request objects. - signatureRequestId: Internal ID. Use for follow-up tool calls (cancel, download, remind). Do not display unless the user explicitly needs it. - title: The document title of the signature request. - status: Overall request state. One of: "awaiting_signature", "completed", "declined", "expired". - dateSent: ISO 8601 timestamp when the request was sent. - dateCompleted: ISO 8601 timestamp when all signers completed (empty if not yet completed). - requesterEmailAddress: Email address of the person who sent the request. - signatures[]: Array of signers on this request. - signerName: Signer's display name. - signerEmailAddress: Signer's email address. - statusCode: Per-signer state. One of: "signed", "on_hold", "awaiting_signature", "awaiting_my_signature", "declined", "expired". - order: Signing order position (0-based). ASSISTANT POLICY — Searching and filtering: - When the user asks to find requests sent TO a specific person, match against signatures[].signerEmailAddress and signatures[].signerName (case-insensitive partial match). - When the user asks to find requests FROM a specific person, match against requesterEmailAddress (case-insensitive partial match). Do not claim to filter by requester name. - When the user asks about requests by status (e.g. "completed", "pending", "awaiting signature", "declined", "expired"), match against the status field. Treat "pending" as equivalent to "awaiting_signature". - When the user asks about requests by date or time range (e.g. "last week", "in September"), use dateSent for sent or created ranges and dateCompleted for completion ranges. - When the user asks about requests by title or document name, match against the title field (case-insensitive partial match). - When combining criteria (e.g. "completed requests sent to Alice last month"), apply all filters together. - Present results in a clear summary: title, status, date sent, and signer names. Include dateCompleted for completed requests. - This tool returns at most 50 results. If the result set is at the limit, inform the user that there may be additional matching requests not shown. ASSISTANT POLICY — General: - Do not display signer email addresses or requesterEmailAddress unless the user specifically asks for them or needs to disambiguate between people with similar names. - Treat signatureRequestId as an internal reference for follow-up tools rather than a value to display unless the user explicitly needs it. - Use signer details to show the exact people who would receive a reminder before confirmation. - Only after the tool returns successfully and you present the results, conversationally offer relevant next steps in your own words. Tailor the suggestions to the results and the user's request instead of reciting every option every time: - Download a completed or pending signature request. - Cancel a pending signature request. - Send a reminder to pending signers. - Prepare a new document for signature from a file in the user's Dropbox. To start, the user can identify the Dropbox file and provide each signer's name and email address; signer details can also be added later in the Dropbox Sign editor. - Make it clear that the user can ask for these follow-up actions in the current chat. Do not claim an action has been taken until its corresponding tool has completed successfully. - If the tool returns an error, do not offer these follow-up actions. - If access is denied…

sign_send_signature_request_reminders

ChatGPT
Send reminders for a Dropbox Sign signature request. Use this only after the user has selected an incomplete request from sign_list_signature_requests. Before calling, identify the exact recipients who will be contacted and obtain clear confirmation. Do not expose the raw signature_request_id in that confirmation. The tool accepts the internal signature-request ID and an optional email_addresses list of up to 50 unique recipients. When email_addresses is omitted or empty, it determines eligible recipients from the request data fetched before sending. For unordered signing, it sends one reminder to every recipient currently awaiting signature. When email addresses are provided, it sends reminders only to requested recipients who are currently eligible. A requested address that belongs to the request but is not eligible is returned as not_currently_eligible; an address that is not a recipient is returned as recipient_not_found. For ordered signing, only the current eligible signer can be reminded. Other requested recipients are reported as not_currently_eligible, and the response's is_ordered_signing, current_signer_email, and current_signer_name fields identify who can currently be reminded. If the current user is the recipient expected to sign, the tool does not send them a reminder; the result says signature_required. The current signer name falls back to their email address when Sign has no name. The tool never intentionally sends reminders to signed, declined, expired, on-hold, or later ordered recipients. The response's request status is the status observed immediately before sending reminders; the tool does not refresh it afterward. Call this tool exactly once after confirmation. It makes one underlying Sign reminder call per eligible recipient and does not retry. A recipient result of sent confirms that Sign accepted that reminder. rate_limited means Sign indicates the recipient was reminded recently; do not retry automatically. sign_rejected means Sign could no longer send the reminder, and account_unavailable means the connected Sign account cannot send it. failed means the outcome is unknown. signature_required, not_currently_eligible, and recipient_not_found mean no reminder was attempted. Do not retry unsuccessful recipients automatically.

upload_file

ChatGPT
Tool Name: dropbox.upload_file Purpose: Upload a file from the current conversation to Dropbox. When to use: When the user explicitly asks to save a file (attachment, generated artifact, or file-library selection) to a specific Dropbox destination. BEHAVIOR: - upload_file saves files from the conversation to Dropbox using the ChatGPT openai/fileParams adapter. - Do NOT construct source_file manually; it is always injected by ChatGPT. ASSISTANT POLICY: - Before calling, ensure the source file and exact Dropbox destination are unambiguous. - An explicit user request to upload or save an unambiguous source file to a complete fq_path or ns_path destination (including the filename) counts as explicit user confirmation; do NOT ask for separate confirmation. - If the source file or exact destination is missing or ambiguous, ask the user to clarify before calling. - Do NOT call without an explicit user request. - Do NOT pass free-form URLs, only files provided through the ChatGPT file parameter. - If Dropbox normalization changes the final path, show it and confirm again. PATHS: - Input destination_path accepts fq_path or ns_path. - Namespace IDs in ns_path are decimal digits and match [0-9]+. - file_id and Dropbox shared/web URLs are not accepted as destination. - Paths are case-insensitive. - Parent must exist. This tool does not create missing parent folders. REQUEST CONTRACT: - destination_path (string, REQUIRED): Full Dropbox path including filename. - source_file (object, REQUIRED): File object injected by ChatGPT file parameter. Do NOT construct this manually. RESPONSE CONTRACT: When status is "completed": - status: "completed" - file: object with name, path, modified_time, file_id, object_type, file.size, path_display. - modified_time is the server-side modification time, in ISO 8601 format when available. When status is "in_progress": - status: "in_progress" - operation_id: opaque token for polling via dropbox.check_upload_file_status. ERRORS: - INVALID_PATH: destination path is empty or invalid - INVALID_SOURCE_FILE: source_file is missing, is missing download_url, contains unknown fields, or download_url points at a host not permitted for ChatGPT fileParam uploads - PARENT_NOT_FOUND: parent path doesn't exist - ALREADY_EXISTS: file exists at target path (do NOT retry with same path; ask the user for a different name or location) - PERMISSION_DENIED: no write access - QUOTA_EXCEEDED: account storage quota exceeded - RATE_LIMITED: too many concurrent requests; retry after delay - TEAM_ROOT_NOT_WRITABLE: cannot write directly in team root RETRY GUIDANCE: - Do NOT retry on ALREADY_EXISTS or TEAM_ROOT_NOT_WRITABLE. - Follow the ASSISTANT POLICY above before calling; an explicit request with an unambiguous source file and exact destination is sufficient explicit user confirmation. - MUST NOT claim the mutation already happened until the tool returns a successful response. - Use dropbox.check_upload_file_status to poll async operations. how to revert the change: - Use dropbox.delete to remove the uploaded file. - https://help.dropbox.com/delete-restore/recover-deleted-files-folders - https://help.dropbox.com/delete-restore/recover-older-versions - https://help.dropbox.com/share/unshare-folder EXAMPLES: {"destination_path": "/Documents/report.pdf", "source_file": {"download_url": "https://files.oaiusercontent.com/report.pdf", "file_id": "file-abc123", "mime_type": "application/pdf", "file_name": "report.pdf"}} {"destination_path": "ns:123//Projects/image.png", "source_file": {"download_url": "https://files.oaiusercontent.com/image.png", "file_id": "file-xyz789"}}

who_am_i

ChatGPT
Tool Name: dropbox.who_am_i Purpose: Get identity, team, and namespace-root information for the authenticated Dropbox user. PARAMETERS: None required. RESPONSE CONTRACT: - account_id: Public Dropbox account ID (pid_eci) - display_name: User's full display name - email: User's email address - country, locale: Account profile fields from the authenticated user context - team_id, team_name: Team fields. team_id is a public Dropbox team ID (pid_eci). If omitted, this is a personal account. If present, this is a team account. - root_namespace_id, home_namespace_id: Namespace root fields for interpreting Dropbox paths ASSISTANT POLICY: Use this when the user asks who they are signed in as, what team/account Dropbox MCP is using, or when you need the user's root namespace or home namespace for path reasoning.

add_folder_member

Claude

check_job_status

Claude

copy

Claude

copy_file

Claude

create_file

Claude

create_file_request

Claude

create_folder

Claude

create_or_append_to_text_file

Claude

create_text_file

Claude

delete

Claude

delete_file

Claude

delete_folder

Claude

fetch

Claude

file_preview

Claude

find_file

Claude

find_folder

Claude

get_dynamic_properties_schema

Claude

get_file_metadata

Claude

get_file_request

Claude

get_latest_new_file_in_folder

Claude

get_latest_new_folder

Claude

get_latest_new_or_updated_file

Claude

get_latest_shared_folders

Claude

list_dynamic_enum_values

Claude

list_file

Claude

list_file_requests

Claude

list_folder

Claude

list_folder_contents

Claude

list_shared_folder

Claude

list_space

Claude

make_api_get_request

Claude

make_api_mutating_request

Claude

move

Claude

move_file

Claude

rename_file

Claude

upload_file

Claude

who_am_i

Claude

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/dropbox"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/dropbox)