Box MCP server for AI agents
Search, organize and share Box files and folders: copy, move, rename and delete them, and manage comments, tasks, collaborators and shared links.
BoxOAUTH2Runs with your users' own Box accounts. Credentials stay on prompt-tm.com.
21 tools · 0 triggers
- Auth
- OAuth 2.0 (sign in with the app)
- Tools
- 21
- Triggers
- 0
- Category
- Documents, Productivity
Tools and triggers
Get the current user
BOX_GET_CURRENT_USER
Returns the connected Box user: name, login email, storage used and enterprise.read-only
Search files and folders
BOX_SEARCH_FOR_CONTENT
Searches names, descriptions, file contents, comments and tags of the files, folders and web links the user can see. Filter by type, extension, folder, owner or dates.read-only
Get a folder
BOX_GET_FOLDER_INFORMATION
Retrieves details for a folder, including the first 100 entries in the folder.read-only
List folder items
BOX_LIST_ITEMS_IN_FOLDER
Lists the files, folders and web links in a folder, one page at a time. The root folder's ID is `0`.read-only
Create a folder
BOX_CREATE_FOLDER
Creates an empty folder inside a parent folder (`0` for the root).
Update a folder
BOX_UPDATE_FOLDER
Renames, moves or describes a folder, or changes its shared link, tags and collaboration settings.destructive
Delete a folder
BOX_DELETE_FOLDER
Deletes a folder, either by moving it to the trash or permanently. Set recursive to delete a folder that isn't empty.destructive
Copy a folder
BOX_COPY_FOLDER
Creates a copy of a folder within a destination folder. The original folder will not be changed.
Get a file
BOX_GET_FILE_INFORMATION
Returns a file's details: name, size, parent folder, owner, version, shared link and timestamps.read-only
Update a file
BOX_UPDATE_FILE
Renames, moves or describes a file, or changes its shared link, lock, tags or collections.destructive
Delete a file
BOX_DELETE_FILE
Deletes a file, either by moving it to the trash or permanently.destructive
Copy a file
BOX_COPY_FILE
Copies a file into a folder, optionally under a new name or from an older version.
List file versions
BOX_LIST_ALL_FILE_VERSIONS
Lists the earlier versions of a file. Box keeps versions only on paid plans; the current version is on Get a file.read-only
List file comments
BOX_LIST_FILE_COMMENTS
Lists the comments on a file.read-only
Add a comment
BOX_CREATE_COMMENT
Adds a comment to a file, or a reply to another comment.
List file tasks
BOX_LIST_TASKS_ON_FILE
Lists every task on a file (not paginated).read-only
Create a task
BOX_CREATE_TASK
Creates a review or completion task on a file. Assign it to people separately.
List file collaborators
BOX_LIST_FILE_COLLABORATIONS
Lists the users and groups who have access to a file or were invited to it.read-only
Share with a user or group
BOX_CREATE_COLLABORATION
Gives a user (by ID or email) or a group a role on a file or folder.
Create a shared link for a file
BOX_ADD_SHARED_LINK_TO_FILE
Creates or replaces a file's shared link. An empty `shared_link` object uses the enterprise's default settings.destructive
List recent items
BOX_LIST_RECENTLY_ACCESSED_ITEMS
Lists the items the user opened recently: the last 90 days, up to 1,000 items.read-only
Try Box now
Sign in, connect your account and run any of these in the playground, or ask your agent through the router.
- “Get the current user”BOX_GET_CURRENT_USER
- “Search files and folders”BOX_SEARCH_FOR_CONTENT
- “Get a folder”BOX_GET_FOLDER_INFORMATION
Connect via MCP
Create an MCP server for Box in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.
claude mcp add --transport http box \
"https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
--header "x-api-key: ptm_…"Connect via REST
Run a tool with one request. The response is { data, error, successful, log_id } for every tool.
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/BOX_GET_CURRENT_USER \
-H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
-d '{ "user_id": "alice", "arguments": {} }'
