Connect Dropbox to Claude Code
Browse folders, search files, read metadata, create folders, move, copy, delete, and share links. Add Toolspoke to Claude Code once and it can use 12 Dropbox actions. Your Dropbox credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install Dropbox and connect it
Add Dropbox to a project in your Toolspoke workspace.
Press connect and sign in to Dropbox. Toolspoke keeps the token encrypted and refreshes it when it expires, so there is nothing to copy and nothing to rotate by hand.
Choose what Claude Code may do
All 12 actions start on. Switch off any of the 5 actions that change something in Dropbox, and Claude Code gets a refusal if it tries.
What you can ask Claude Code for
A few of the Dropbox actions that only read, so they are safe to try first.
- Return how many bytes this account has used against its allocation
- List the contents of one folder
- Fetch the next page of a listing started by list_folder, using the cursor that listing returned
- Search the account for files and folders by name, and by the text inside documents on paid plans
What Claude Code can do in Dropbox
7 actions read, 2 write and 3 delete or permanently change something.
Reads
Get current account
Return the connected Dropbox account: its account ID, display name, email address, and whether the account belongs to a team. It touches no file, which makes it the cheapest proof that the connection works and the right call to confirm whose Dropbox this is before acting on it.
Get space usage
Return how many bytes this account has used against its allocation. Numbers only, no file, no folder and no name appears in the answer. Call it before a large copy to know whether there is room.
List folder
List the contents of one folder. Paths are Dropbox-style and start with a slash, "/Clients/Acme", and the account's root is the empty string, which is what this sends when no path is given. The answer carries `cursor` and `has_more`; when `has_more` is true, pass that cursor to list_folder_continue for the next page rather than calling this again. Set recursive to walk every subfolder in one call, but be aware Dropbox warns that a deep tree can time out, walking one level at a time is the reliable way through a large account.
List folder continue
Fetch the next page of a listing started by list_folder, using the cursor that listing returned. The cursor also works as a change token: calling this again later returns only what has been added, changed or removed since, which is how a folder is watched without listing it repeatedly.
Search files
Search the account for files and folders by name, and by the text inside documents on paid plans. Returns matches with each item's path, so a hit can be handed straight to get_metadata or create_shared_link. Narrow it with search_path to look inside one folder, with file_extensions to keep to one kind of file, or with filename_only when the words are expected in the name rather than the contents.
Get metadata
Read one file's or folder's metadata by path or by ID, its name, size, revision, when it last changed, and whether it is shared. Dropbox does not support metadata for the account's root, so this needs a real path; use list_folder to see what is at the top level.
List shared links
List the shared links this account has already created, with the file or folder each one points at. Give a path to see the links for one item; omit it to page through every link on the account. Call this before create_shared_link. Dropbox refuses to create a second link with the same settings for an item that already has one, and the existing link is usually the answer anyway.
Writes
Create folder
Create one empty folder at a path. Every folder above it has to exist already; Dropbox does not create intermediate folders. With autorename true, a name that is already taken becomes "Reports (1)" instead of failing.
Copy file
Copy a file or folder to another path. The original is untouched and the copy is a new item with its own ID, so nothing is lost and this stays a write while move_file does not. Copying a folder copies what is inside it.
Deletes or permanently changes
Create shared link
Create a shared link for a file or folder. Classified destructive, alongside deleting: with audience "public" the link works for anybody who has the URL, signed in or not, and a URL that has been sent somewhere cannot be un-sent. Set audience "team" to keep it inside the Dropbox team, or "no_one" for a link that only points members at content they can already reach. Prefer list_shared_links first. Dropbox rejects a second link with the same settings on an item that already has one.
Delete file
Delete a file or folder. Deleting a folder takes everything inside it. Dropbox keeps a deleted item recoverable from the web interface for the account's retention window, 30 days on most plans, but it leaves the folder now, which is why this is gated with sharing rather than with renaming. This is not permanent deletion: that needs the files.permanent_delete scope, which this connector never asks for, so no grant here can destroy something outright.
Move file
Move or rename a file or folder. Classified destructive rather than write because the old location is gone afterwards: anybody or anything holding the previous path, a link in a document, a script, a colleague's bookmark, no longer finds it, and there is no undo. Use copy_file when the original should stay where it is.
Dropbox in Claude Code: questions
Does Claude Code see my Dropbox credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Can I stop Claude Code from changing things in Dropbox?
Yes. Each of the 12 actions can be switched off for a project. Turn off the 5 that change something and Claude Code can only read.
Will 12 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Dropbox action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan, and a Dropbox call does not run in a sandbox, so it bills nothing.
Dropbox in your other apps
Try Dropbox in Claude Code
Free to start, and tool calls cost nothing on any plan.