Box Integration

Pro v1.0.0

Upload, download, and manage files and folders in Box cloud storage

Requires Claude Code CLI

This skill integrates with Box through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

List Folder Contents

List all files and folders in a specific Box folder

Parameters

Name Type Required Description
folder_id string Required ID of the folder to list (0 for root)
fields string Optional Comma-separated list of fields to display

Try saying...

  • "List files in my Box root folder"
  • "Show me what's in folder 12345"
  • "List all items in the Box root directory"

Upload File

Upload a local file to Box

Parameters

Name Type Required Description
path string Required Local path to the file to upload
parent_id string Optional ID of the parent folder (defaults to 0/root)

Try saying...

  • "Upload document.pdf to Box"
  • "Upload ./reports/q1.xlsx to folder 98765"
  • "Upload this file to my Box account"

Download File

Download a file from Box to local machine

Parameters

Name Type Required Description
file_id string Required ID of the file to download
destination string Optional Local path to save the file

Try saying...

  • "Download file 123456789 from Box"
  • "Download the presentation to my downloads folder"
  • "Get file with ID 987654321"

Create Folder

Create a new folder in Box

Parameters

Name Type Required Description
parent_id string Required ID of the parent folder
name string Required Name for the new folder

Try saying...

  • "Create a folder named 'Projects' in my root directory"
  • "Make a new folder called 'Team Documents'"
  • "Create folder 'Archive' in folder 12345"

Upload Folder

Upload an entire local folder with all its contents to Box

Parameters

Name Type Required Description
path string Required Local path to the folder to upload
parent_folder string Optional ID of the parent folder in Box (defaults to 0/root)

Try saying...

  • "Upload the entire ./projects folder to Box"
  • "Upload folder ./team-docs to my Box account"
  • "Upload this directory to folder 98765"

Search

Search for files and folders across your Box account

Parameters

Name Type Required Description
query string Required Search query string
type string Optional Filter by type: file or folder

Try saying...

  • "Search Box for 'quarterly report'"
  • "Find all files containing 'budget'"
  • "Search for folders named 'Archive'"

Delete File

Move a file to trash or permanently delete it

Parameters

Name Type Required Description
file_id string Required ID of the file to delete
force boolean Optional Permanently delete (bypass trash)

Try saying...

  • "Delete file 123456"
  • "Permanently remove file 987654"
  • "Move file to trash"

Share File

Create a shared link for a file

Parameters

Name Type Required Description
file_id string Required ID of the file to share
access string Optional Access level for the shared link

Try saying...

  • "Create a shareable link for file 123456"
  • "Share file 987654 with my company"
  • "Generate a public link for this file"

Getting Started

CLI Authentication Moderate Setup
  1. 1 Install the CLI: npm install --global @box/cli (or download platform installer)
  2. 2 Go to Box Developer Console: https://app.box.com/developers/console
  3. 3 Create a Custom App with User Authentication (OAuth 2.0)
  4. 4 Configure OAuth redirect URI: http://localhost:3000/callback
  5. 5 Copy your Client ID
  6. 6 Run: box configure:environments:add --name default
  7. 7 Enter Client ID when prompted and authorize in browser

Verify Setup

box users:get me

Success: Returns your Box user information

Security & Access

Access Scope

Full access to your Box account based on the scopes you select when creating your Custom App. Can read, write, delete files and folders.

  • The CLI requires creating a Custom App in the Box Developer Console
  • OAuth tokens are stored locally in ~/.box - keep this directory secure
  • Review and limit application scopes to only what you need
  • Tokens provide full access to selected scopes - treat them as passwords
  • For enterprise security, consider using JWT authentication instead of OAuth 2.0
  • Revoke app access at any time from the Developer Console

Limitations

  • File size limits depend on your Box plan (typically 5GB for free, 50GB+ for enterprise)
  • OAuth tokens expire after 60 minutes (CLI auto-refreshes)
  • Refresh tokens expire after 60 days (requires re-authentication)

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
CLI
Auth
CLI Authentication
Setup
Moderate Setup
Tools Required
Bash
CLI Dependencies
box

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements