Skip to Content

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:

  1. 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.
  2. 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.
  3. 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:

  1. Go to Integrations in Town
  2. Find Box and click Add account
  3. Keep or edit the account label and click Continue
  4. Sign in to Box and grant access
  5. 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

CapabilityWhat it doesMakes changes?
Search foldersFind folders by nameNo
Search filesFind files by keyword or metadataNo
List folder contentsSee what’s inside a folderNo
Read file contentOpen and read a fileNo
Get file/folder detailsRead properties like size, owner, and datesNo
Read commentsRead the comments on a fileNo
List collaborationsSee who a file or folder is shared withNo
Read metadataInspect metadata templates and file metadataNo
Preview a filePull a file preview or preview pageNo
List tasksSee tasks attached to a fileNo
Upload a fileCreate a new text file in a folderYes — with approval
Upload a file versionReplace a file’s content with a new versionYes — with approval
Create a folderAdd a new folderYes — with approval
Comment on a filePost a comment for collaboratorsYes — with approval
Rename / update propertiesRename an item or edit its description and tagsYes — with approval
Copy a file or folderDuplicate an item into another folderYes — with approval
Move a file or folderRelocate an item to another folderYes — with approval
Set metadataApply metadata template values to an itemYes — with approval
Get a download linkMint a time-limited link to a file’s raw contentsNo
Get an upload linkMint a single-use link for a binary uploadYes — with approval
Manage metadata templatesCreate or update enterprise metadata templatesYes — 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 lands

Best 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
Last updated on