Box
Connect Box and your assistant can find, read, and summarize your files — search folders and files, open documents and previews, and pull comments, metadata, and collaboration details — and it can also do the busywork in Box for you: upload files, create folders, post comments, keep things organized, and maintain metadata.
Reading never needs sign-off. Anything that changes your Box content — an upload, a move, a rename, a comment — asks for your approval first by default, so nothing in your account changes without you saying so unless you’ve explicitly told a routine it may run a specific Box tool without asking.
What’s included
With Box connected, your assistant can:
- Search files and folders — by name, keyword, or metadata
- Browse folder contents — list what’s inside any folder
- Read file content — open and read documents to answer questions or summarize
- Read file and folder details — size, owner, dates, and other properties
- Read comments — see the discussion on a file
- See collaborations — who a file or folder is shared with
- Read metadata — inspect metadata templates and the values on a file
- Preview files — pull a file preview or a specific preview page
- Upload files — create new text files, or upload a new version of an existing file (with approval)
- Transfer binary files — upload PDFs, Office files, and other binaries via secure single-use links, and mint download links for raw file contents (uploads with approval; requires a Box admin to enable the upload/download URL tools)
- Create folders — set up folder structures (with approval)
- Post comments — leave a comment for a file’s collaborators (with approval)
- Organize content — copy, move, and rename files and folders, and update descriptions and tags (with approval)
- Maintain metadata — apply metadata template values to files and folders, and create or update enterprise metadata templates (with approval)
For Box admins: manage Town’s access
Town connects through Box’s official MCP server (mcp.box.com), which Box documents as available on Business plans and above (developer sandboxes include it too). If the Box MCP Server tab does not appear in your Admin Console, your Box plan likely does not include it. Box gives admins a dedicated page controlling exactly what that server can do for your enterprise — open it directly:
app.box.com/master/settings/mcp (Admin Console → Integrations → Box MCP Server tab)
The page lists tool categories — Search, Files & Folders, Box AI & Agents, and so on — each with its own enablement dropdown. Most categories are enabled by default, which is why connecting to Town usually works without any admin action. Three things are worth checking:
- Category enablement — each category’s dropdown (for example, “Enable read & write tools”) controls which of its tools Box serves. Anything you disable stops working for Town immediately, enforced on Box’s side.
- Binary transfer toggles — off by default. Under Files & Folders → Custom configuration, enable Get Upload URL and confirm Get Download URL is on, then Save. Without these, Town can’t upload or download binary files (PDFs, Office files, images) — only text files.
- Server state. The tool-category page configures tools but does not flip the server’s own on/off state, and whether that state starts enabled varies with your enterprise’s integration settings. If connecting from Town fails at the Box sign-in step, set it explicitly: Admin Console → Integrations → Integrations list, find Box MCP Server, and choose an enabled state — this covers both never-enabled and previously-disabled enterprises.
No new content access is granted. A connected user can only ever see or change what their own Box account already can — permissions are enforced by Box on every call, and every change Town makes is logged and attributed to the specific user in Box’s audit trail.
The tool list is your control panel. Any tool you disable in the Box MCP Server configuration stops working for Town immediately, enforced on Box’s side.
Skip ”+ Add Integration Credentials.” That flow (Client ID, Redirect URI, scopes) is for teams building their own MCP client — Town brings its own. You only need the enable toggle and, optionally, the per-tool configuration.
For users: connect Box to Town
In our testing, Box’s defaults allow connecting with no admin action — though enterprises that restrict new integrations will need the admin section above first:
- Go to Integrations in Town
- Find Box and click Add account
- Keep or edit the account label and click Continue
- Sign in to Box and grant access
- Back in Town, the account appears with a green dot — try “Find <a file you know> in Box”
Your assistant is limited to the files and folders your Box account can already access, and you can revoke access anytime from Box settings or by disconnecting the account in Town.
If a Box tool errors or binary upload isn’t available: your enterprise’s Box admin controls the tool list — most often the binary-transfer toggles (off by Box’s default) haven’t been enabled. Send your Box admin the link above.
What your assistant can do
| Capability | What it does | Makes changes? |
|---|---|---|
| Search folders | Find folders by name | No |
| Search files | Find files by keyword or metadata | No |
| List folder contents | See what’s inside a folder | No |
| Read file content | Open and read a file | No |
| Get file/folder details | Read properties like size, owner, and dates | No |
| Read comments | Read the comments on a file | No |
| List collaborations | See who a file or folder is shared with | No |
| Read metadata | Inspect metadata templates and file metadata | No |
| Preview a file | Pull a file preview or preview page | No |
| List tasks | See tasks attached to a file | No |
| Upload a file | Create a new text file in a folder | Yes — with approval |
| Upload a file version | Replace a file’s content with a new version | Yes — with approval |
| Create a folder | Add a new folder | Yes — with approval |
| Comment on a file | Post a comment for collaborators | Yes — with approval |
| Rename / update properties | Rename an item or edit its description and tags | Yes — with approval |
| Copy a file or folder | Duplicate an item into another folder | Yes — with approval |
| Move a file or folder | Relocate an item to another folder | Yes — with approval |
| Set metadata | Apply metadata template values to an item | Yes — with approval |
| Get a download link | Mint a time-limited link to a file’s raw contents | No |
| Get an upload link | Mint a single-use link for a binary upload | Yes — with approval |
| Manage metadata templates | Create or update enterprise metadata templates | Yes — with approval |
By default, every change shows you an approval card first — what will change and where — and runs only after you approve it. The exception is a tool you’ve deliberately set to run without asking in a routine’s tool settings (see Best practices below). Direct uploads are text files (documents, notes, CSV, code); binary files (PDF, Office, images) go through secure single-use upload links when your Box admin has enabled those tools.
Use cases
Find the right file fast
Stop hunting through folders:
- “Find the signed MSA for Acme in Box”
- “What’s in the Q3 board folder?”
- Search by keyword or metadata when you don’t remember the file name
Read and summarize
Turn a document into an answer:
- “Summarize the vendor contract in Box”
- Pull the key terms from a file without opening it
- Answer a question from a report stored in Box
File and organize
Let your assistant do the tidying:
- “Save these meeting notes to the Client folder in Box”
- “Set up a folder structure for the new project”
- “Move last quarter’s reports into the archive folder”
- “Tag these contracts with the Legal metadata template”
Bring Box into your other work
Fold file context into everything else:
- Add the relevant Box document to a meeting brief
- Combine a Box file with your email and calendar in one request
- Check who a folder is shared with before you send a link
Example routine
A routine that files meeting notes automatically:
After each client meeting:
1. Draft the meeting notes
2. Find the client's folder in Box
3. Upload the notes as a new file in that folder
4. Ask me to approve the upload before it landsBest practices
Point to the right folder. If a search is too broad, name the folder or add a keyword so your assistant reads the file you mean.
Changes ask first by default. Uploads, moves, renames, comments, and metadata edits show an approval card before anything happens. For a routine you trust, you can set an individual tool to run without asking in the routine’s tool settings — that tool’s changes then run without a card, so grant it deliberately.
Troubleshooting
Can’t connect
- Make sure you’re signing in to the correct Box account
- Complete Box’s authorization screen and return to Town
- If your enterprise restricted the Box MCP server, ask your Box admin to check its settings (see “For Box admins” above) — and note Box documents the MCP server for Business plans and above
Can’t find a file
- Verify the file or folder exists and your Box account can access it
- Try a keyword or metadata search instead of an exact name
- Check that the content isn’t in a folder you don’t have access to
Can’t read a file
- Very large files or unsupported formats may not read fully
- Confirm your Box permissions allow viewing the file
A change didn’t happen
- Check for a pending approval card — changes wait for your sign-off
- Confirm your Box permissions allow editing the item
- Some tools depend on what your Box enterprise admin has enabled for Box’s MCP server — the per-tool steps are in “For Box admins” above
- Binary upload/download specifically needs the Get Upload URL / Get Download URL toggles from that section
Related
- Integrations overview — How integrations give your assistant context
- Context and memory — How your assistant remembers and reuses what it learns
Town