Connect Box to Claude Code
Browse folders, search content, read file and folder details, create folders, delete, share links, and see who has access. Add Toolspoke to Claude Code once and it can use 11 Box actions. Your Box 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 Box and connect it
Add Box to a project in your Toolspoke workspace.
Server authentication (Client Credentials Grant). You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.
- Client ID
- Box Developer Console → your app → Configuration → OAuth 2.0 Credentials. The app must be of type Server Authentication (with Client Credentials Grant), and must be authorised in the Box Admin Console before any token is issued.
- Client secret
- Shown beside the client ID in the Developer Console. Viewing it requires two-factor authentication on the Box account.
- Enterprise ID
- Box Developer Console → General Settings → App Info → Enterprise ID. If you set the subject type below to "user", put that user's ID here instead.
Choose what Claude Code may do
All 11 actions start on. Switch off any of the 4 actions that change something in Box, and Claude Code gets a refusal if it tries.
What you can ask Claude Code for
A few of the Box actions that only read, so they are safe to try first.
- Return the Box identity this connection authenticates as, its user ID, name, login, and status
- List what is directly inside one folder, its files, subfolders and web links
- Search Box for files, folders and web links
- List the people in this Box enterprise, optionally narrowed by a name or login prefix
What Claude Code can do in Box
7 actions read, one writes and 3 delete or permanently change something.
Reads
Get current user
Return the Box identity this connection authenticates as, its user ID, name, login, and status. With the default enterprise subject type that is the app's Service Account rather than a person, and its ID is what a folder has to be collaborated to before this connector can see the folder. It reads no file, which makes it the right proof that the credential works.
List folder items
List what is directly inside one folder, its files, subfolders and web links. The root folder of any Box account is always id "0", which is where to start. Box returns a small "mini" representation of each item by default, so this asks for a useful set of fields instead; widen or narrow it with `fields`. For a folder with more entries than one page holds, set use_marker true and pass the `next_marker` from the response back as `marker`.
Get folder
Read one folder's own details, its name, where it sits, when it changed, how big it is, and whether it already has a shared link. Use "0" for the account root. This does not list what is inside it; that is list_folder_items.
Get file
Read one file's details, its name, size, type, the folder it sits in, when it last changed, and whether it already has a shared link. This returns information about the file, not its contents: downloading bytes is a different Box host and this connector does not carry it.
Search files
Search Box for files, folders and web links. The query matches names, descriptions and the text inside documents, and supports "exact phrase" in double quotes together with AND, OR and NOT in capitals. Narrow it with `type` to one kind of item, with `ancestor_folder_ids` to look inside particular folders, or with `content_types` to say where the words should appear. The default scope is what this connection can already reach; enterprise_content searches the whole enterprise and has to be enabled by Box support first.
List collaborations
List who has been given access to one file and in what role, editor, viewer, previewer, uploader, co-owner and so on. Read it before create_shared_link to see whether the person who needs the file already has it, which is the reversible way to give somebody access.
List users
List the people in this Box enterprise, optionally narrowed by a name or login prefix. Their IDs are what a collaboration is granted to. Reading this needs an identity with admin rights in the enterprise, which the Service Account has by default. Note that user_type "external" and "all" reach beyond the enterprise's own staff to people outside it.
Writes
Create folder
Create one empty folder inside another. `parent_id` defaults to "0", the account root; with the Service Account identity that root is the app's own, not anybody's My Files, so a folder is usually wanted inside a folder that has been collaborated to this connection. Box rejects a name that already exists in the same parent, and rejects slashes, leading or trailing spaces, "." and "..".
Deletes or permanently changes
Create shared link
Put a shared link on a file. Classified destructive, alongside deleting: with access "open" the link works for anybody who has the URL, signed in to Box or not, and a URL that has been sent somewhere cannot be un-sent. "company" keeps it inside the enterprise and needs a paid plan; "collaborators" only works for people already invited to the file, which is the safe default when a link is wanted for convenience rather than for sharing. Setting `unshared_at` bounds the exposure. Box replaces any link the file already had, so read get_file first to see whether one exists.
Delete file
Delete one file. Box moves it to the enterprise's trash, where it stays recoverable for the retention window an admin has set, 30 days by default, and is then removed for good. Pass `if_match` with the file's `etag` from get_file to have Box refuse the delete if somebody has changed the file since it was read. Box answers with an empty 204 on success.
Delete folder
Delete one folder. Box refuses a folder that still has anything in it unless `recursive` is true, and recursive deletion takes every file and subfolder with it. Everything goes to the enterprise's trash and is recoverable for the retention window an admin has set. Box answers with an empty 204 on success.
Box in Claude Code: questions
Does Claude Code see my Box 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 Box?
Yes. Each of the 11 actions can be switched off for a project. Turn off the 4 that change something and Claude Code can only read.
Will 11 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 Box 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 Box call does not run in a sandbox, so it bills nothing.
Box in your other apps
Try Box in Claude Code
Free to start, and tool calls cost nothing on any plan.