Box Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Box MCP or direct API to upload files, fetch documents, manage folders, and share content through natural language.
BOOK A CALLGET STARTED FOR FREE
Box Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Supported Tools

Tools
Add classification to fileAdds a classification to a file by specifying the label of the classification to add.
Add classification to folderAdds a classification to a folder by specifying the label of the classification to add.
Add domain to list of allowed collaboration domainsCreates a new entry in the list of allowed domains to allow collaboration for.
Add initial classificationsWhen an enterprise does not yet have any classifications, this api call initializes the classification template with an initial set of classifications.
Add or update user avatarAdds or updates a user avatar.
Add shared link to fileAdds a shared link to a file.
Add shared link to folderAdds a shared link to a folder.
Add shared link to web linkAdds a shared link to a web link.
Add user to groupCreates a group membership.
Apply watermark to fileApplies or update a watermark on a file.
Apply watermark to folderApplies or update a watermark on a folder.
Ask questionSends an ai request to supported llms and returns an answer specifically focused on the user's question given the provided context.
Assign legal hold policyAssign a legal hold to a file, file version, folder, or user.
Assign retention policyAssigns a retention policy to an item.
Assign storage policyCreates a storage policy assignment for an enterprise or user.
Assign taskAssigns a task to a user.
Authorize userAuthorize a user by sending them through the [box](https://box.
Cancel box sign requestCancels a sign request.
Change shield information barrier statusChange status of shield information barrier with the specified id.
Commit upload sessionClose an upload session and create a file from the uploaded chunks.
Copy fileCreates a copy of a file.
Copy file requestCopies an existing file request that is already present on one folder, and applies it to another folder.
Copy folderCreates a copy of a folder within a destination folder.
Create ai agentCreates an ai agent.
Create box sign requestCreates a signature request.
Create box skill cards on fileApplies one or more box skills metadata cards to a file.
Create collaborationAdds a collaboration for a single user or a single group to a file or folder.
Create commentAdds a comment by the user to a specific file, or as a reply to an other comment.
Create email aliasAdds a new email alias to a user account.
Create folderCreates a new empty folder within the specified parent folder.
Create folder lockCreates a folder lock on a folder, preventing it from being moved and/or deleted.
Create groupCreates a new group of users in an enterprise.
Create jobs to terminate user group sessionValidates the roles and permissions of the group, and creates asynchronous jobs to terminate the group's sessions.
Create jobs to terminate users sessionValidates the roles and permissions of the user, and creates asynchronous jobs to terminate the user's sessions.
Create legal hold policyCreate a new legal hold policy.
Create metadata cascade policyCreates a new metadata cascade policy that applies a given metadata template to a given folder and automatically cascades it down to any files within that folder.
Create metadata instance on fileApplies an instance of a metadata template to a file.
Create metadata instance on folderApplies an instance of a metadata template to a folder.
Create metadata templateCreates a new metadata template that can be applied to files and folders.
Create retention policyCreates a retention policy.
Create shield information barrierCreates a shield information barrier to separate individuals/groups within the same firm and prevents confidential information passing between them.
Create shield information barrier reportCreates a shield information barrier report for a given barrier.
Create shield information barrier segmentCreates a shield information barrier segment.
Create shield information barrier segment memberCreates a new shield information barrier segment member.
Create shield information barrier segment restrictionCreates a shield information barrier segment restriction object.
Create slack integration mappingCreates a [slack integration mapping](https://support.
Create taskCreates a single task on a file.
Create teams integration mappingCreates a [teams integration mapping](https://support.
Create terms of serviceCreates a terms of service for a given enterprise and type of user.
Create terms of service status for new userSets the status for a terms of service for a user.
Create upload sessionCreates an upload session for a new file.
Create upload session for existing fileCreates an upload session for an existing file.
Create userCreates a new managed user in an enterprise.
Create user exemption from collaboration domain restrictionsCreate user exemption from collaboration domain restrictions.
Create user inviteInvites an existing external user to join an enterprise.
Create webhookCreates a webhook.
Create web linkCreates a web link object within a folder.
Create zip downloadCreates a request to download multiple files and folders as a single `zip` archive file.
Delete ai agentDeletes an ai agent using the provided parameters.
Delete fileDeletes a file, either permanently or by moving it to the trash.
Delete file requestDeletes a file request permanently.
Delete folderDeletes a folder, either permanently or by moving it to the trash.
Delete folder lockDeletes a folder lock on a given folder.
Delete retention policyPermanently deletes a retention policy.
Delete shield information barrier segmentDeletes the shield information barrier segment based on provided id.
Delete shield information barrier segment member by idDeletes a shield information barrier segment member based on provided id.
Delete shield information barrier segment restriction by idDelete shield information barrier segment restriction by id.
Delete slack integration mappingDeletes a [slack integration mapping](https://support.
Delete teams integration mappingDeletes a [teams integration mapping](https://support.
Delete userDeletes a user.
Delete user avatarRemoves an existing user avatar.
Download fileReturns the contents of a file in binary format.
Download zip archiveReturns the contents of a `zip` archive in binary format.
Extract metadata freeformSends an ai request to supported large language models (llms) and extracts metadata in form of key-value pairs.
Extract metadata structuredSends an ai request to supported large language models (llms) and returns extracted metadata as a set of key-value pairs.
Find app item for shared linkReturns the app item represented by a shared link.
Find file for shared linkReturns the file represented by a shared link.
Find folder for shared linkReturn the folder represented by a shared link.
Find metadata template by instance idFinds a metadata template by searching for the id of an instance of the template.
Find web link for shared linkReturns the web link represented by a shared link.
Force apply metadata cascade policy to folderForce the metadata on a folder with a metadata cascade policy to be applied to all of its children.
Generate textSends an ai request to supported large language models (llms) and returns generated text based on the provided prompt.
Get ai agent by agent idGets an ai agent using the `agent id` parameter.
Get ai agent default configurationGet the ai agent default config
Get allowed collaboration domainReturns a domain that has been deemed safe to create collaborations for within the current enterprise.
Get box sign request by idGets a sign request by id.
Get box sign template by idFetches details of a specific box sign template.
Get classification on fileRetrieves the classification metadata instance that has been applied to a file.
Get classification on folderRetrieves the classification metadata instance that has been applied to a folder.
Get collaborationRetrieves a single collaboration.
Get collection by idRetrieves a collection by its id.
Get commentRetrieves the message and metadata for a specific comment, as well as information on the user who created the comment.
Get current userRetrieves information about the user who is currently authenticated.
Get device pinRetrieves information about an individual device pin.
Get events long poll endpointThe listevents endpoint provides information about the events available in the box system.
Get file informationRetrieves the details about a file.
Get file requestRetrieves the information about a file request.
Get files under retentionReturns a list of files under retention for a retention policy assignment.
Get file thumbnailRetrieves a thumbnail, or smaller image representation, of a file.
Get file versionRetrieve a specific version of a file.
Get file version legal holdRetrieves information about the legal hold policies assigned to a file version.
Get file versions under retentionReturns a list of file versions under retention for a retention policy assignment.
Get folder informationRetrieves details for a folder, including the first 100 entries in the folder.
Get groupRetrieves information about a group.
Get group membershipRetrieves a specific group membership.
Get legal hold policyRetrieve a legal hold policy.
Get legal hold policy assignmentRetrieve a legal hold policy assignment.
Get metadata cascade policyRetrieve a specific metadata cascade policy assigned to a folder.
Get metadata instance on fileRetrieves the instance of a metadata template that has been applied to a file.
Get metadata instance on folderRetrieves the instance of a metadata template that has been applied to a folder.
Get metadata template by idRetrieves a metadata template by its id.
Get metadata template by nameRetrieves a metadata template by its `scope` and `templatekey` values.
Get retention on fileReturns information about a file version retention.
Get retention policyRetrieves a retention policy.
Get retention policy assignmentRetrieves a retention policy assignment
Get shared link for fileGets the information for a shared link on a file.
Get shared link for folderGets the information for a shared link on a folder.
Get shared link for web linkGets the information for a shared link on a web link.
Get shield information barrier report by idRetrieves a shield information barrier report by its id.
Get shield information barrier segment member by idRetrieves a shield information barrier segment member by its id.
Get shield information barrier segment restriction by idRetrieves a shield information barrier segment restriction based on provided id.
Get shield information barrier segment with specified idRetrieves shield information barrier segment based on provided id.
Get shield information barrier with specified idGet shield information barrier based on provided id.
Get storage policyFetches a specific storage policy.
Get storage policy assignmentFetches a specific storage policy assignment.
Get taskRetrieves information about a specific task.
Get task assignmentRetrieves information about a task assignment.
Get terms of serviceFetches a specific terms of service.
Get trashed fileRetrieves a file that has been moved to the trash.
Get trashed folderRetrieves a folder that has been moved to the trash.
Get trashed web linkRetrieves a web link that has been moved to the trash.
Get upload sessionReturn information about an upload session.
Get userRetrieves information about a user in the enterprise.
Get user avatarRetrieves an image of a the user's avatar.
Get user exempt from collaboration domain restrictionsReturns a users who has been exempt from the collaboration domain restrictions.
Get user invite statusReturns the status of a user invite.
Get watermark for folderRetrieve the watermark for a folder.
Get watermark on fileRetrieve the watermark for a file.
Get webhookRetrieves a specific webhook
Get web linkRetrieve information about a web link.
Get zip download statusReturns the download status of a `zip` archive, allowing an application to inspect the progress of the download as well as the number of items that might have been skipped.
List ai agentsLists ai agents based on the provided parameters.
List all classificationsRetrieves the classification metadata template and lists all the classifications available to this enterprise.
List all collectionsRetrieves all collections for a given user.
List all file versionsRetrieve a list of the past versions for a file.
List all global metadata templatesUsed to retrieve all generic, global metadata templates available to all enterprises using box.
List all legal hold policiesRetrieves a list of legal hold policies that belong to an enterprise.
List all metadata templates for enterpriseUsed to retrieve all metadata templates created to be used specifically within the user's enterprise
List allowed collaboration domainsReturns the list domains that have been deemed safe to create collaborations for within the current enterprise.
List all webhooksReturns all defined webhooks for the requesting application.
List box sign requestsGets signature requests created by a user.
List box sign templatesGets box sign templates created by a user.
List box skill cards on fileList the box skills metadata cards that are attached to a file.
List collection itemsRetrieves the files and/or folders contained within this collection.
List enterprise device pinsRetrieves all the device pins within an enterprise.
List enterprise usersReturns a list of all users for the enterprise along with their `user id`, `public name`, and `login`.
List file app item associations**this is a beta feature, which means that its availability might be limited.
List file collaborationsRetrieves a list of pending and active collaborations for a file.
List file commentsRetrieves a list of comments for a file.
List file version legal holdsGet a list of file versions on legal hold for a legal hold assignment.
List file version retentionsRetrieves all file version retentions for the given enterprise.
List folder app item associations**this is a beta feature, which means that its availability might be limited.
List folder collaborationsRetrieves a list of pending and active collaborations for a folder.
List folder locksRetrieves folder lock details for a given folder.
List group collaborationsRetrieves all the collaborations for a group.
List groups for enterpriseRetrieves all of the groups for a given enterprise.
List items in folderRetrieves a page of items in a folder.
List legal hold policy assignmentsRetrieves a list of items a legal hold policy has been assigned to.
List members of groupRetrieves all the members for a group.
List metadata cascade policiesRetrieves a list of all the metadata cascade policies that are applied to a given folder.
List metadata instances on fileRetrieves all metadata for a given file.
List metadata instances on folderRetrieves all metadata for a given folder.
List partsReturn a list of the chunks uploaded to the upload session so far.
List pending collaborationsRetrieves all pending collaboration invites for this user.
List previous file versions for legal hold policy assignmentList previous file versions for legal hold policy assignment
List recently accessed itemsReturns information about the recent items accessed by a user, either in the last 90 days or up to the last 1000 items accessed.
List retention policiesRetrieves all of the retention policies for an enterprise.
List retention policy assignmentsReturns a list of all retention policy assignments associated with a specified retention policy.
List shield information barrier reportsLists shield information barrier reports.
List shield information barriersRetrieves a list of shield information barrier objects for the enterprise of jwt.
List shield information barrier segment membersLists shield information barrier segment members based on provided segment ids.
List shield information barrier segment restrictionsLists shield information barrier segment restrictions based on provided segment id.
List shield information barrier segmentsRetrieves a list of shield information barrier segment objects for the specified information barrier id.
List slack integration mappingsLists [slack integration mappings](https://support.
List storage policiesFetches all the storage policies in the enterprise.
List storage policy assignmentsFetches all the storage policy assignment for an enterprise or user.
List task assignmentsLists all of the assignments for a given task.
List tasks on fileRetrieves a list of all the tasks for a file.
List teams integration mappingsLists [teams integration mappings](https://support.
List terms of servicesReturns the current terms of service text and settings for the enterprise.
List terms of service user statusesRetrieves an overview of users and their status for a terms of service, including whether they have accepted the terms and when.
List trashed itemsRetrieves the files and folders that have been moved to the trash.
List user and enterprise eventsReturns up to a year of past events for a given user or for the entire enterprise.
List user s email aliasesRetrieves all email aliases for a user.
List users exempt from collaboration domain restrictionsReturns a list of users who have been exempt from the collaboration domain restrictions.
List user s groupsRetrieves all the groups for a user.
List workflowsReturns list of workflows that act on a given `folder id`, and have a flow with a trigger type of `workflow manual start`.
Permanently remove filePermanently deletes a file that is in the trash.
Permanently remove folderPermanently deletes a folder that is in the trash.
Permanently remove web linkPermanently deletes a web link that is in the trash.
Preflight check before uploadPerforms a check to verify that a file will be accepted by box before you upload the entire file.
Promote file versionPromote a specific version of a file.
Query files folders by metadataCreate a search using sql-like syntax to return items that match specific metadata.
Refresh access tokenRefresh an access token using its client id, secret, and refresh token.
Remove box skill cards from fileRemoves any box skills cards metadata from a file.
Remove classification from fileRemoves any classifications from a file.
Remove classification from folderRemoves any classifications from a folder.
Remove collaborationDeletes a single collaboration.
Remove commentPermanently deletes a comment.
Remove device pinDeletes an individual device pin.
Remove domain from list of allowed collaboration domainsRemoves a domain from the list of domains that have been deemed safe to create collaborations for within the current enterprise.
Remove email aliasRemoves an email alias from a user.
Remove file versionMove a file version to the trash.
Remove groupPermanently deletes a group.
Remove legal hold policyDelete an existing legal hold policy.
Remove metadata cascade policyDeletes a metadata cascade policy.
Remove metadata instance from fileDeletes a piece of file metadata.
Remove metadata instance from folderDeletes a piece of folder metadata.
Remove metadata templateDelete a metadata template and its instances.
Remove retention policy assignmentRemoves a retention policy assignment applied to content.
Remove shared link from fileRemoves a shared link from a file.
Remove shared link from folderRemoves a shared link from a folder.
Remove shared link from web linkRemoves a shared link from a web link.
Remove taskRemoves a task from a file.
Remove upload sessionAbort an upload session and discard all data uploaded.
Remove User Domain ExemptionRemoves a user's exemption from the restrictions set out by the allowed list of domains for collaborations.
Remove user from groupDeletes a specific group membership.
Remove watermark from fileRemoves the watermark from a file.
Remove watermark from folderRemoves the watermark from a folder.
Remove webhookDeletes a webhook.
Remove web linkDeletes a web link.
Request access tokenRequest an access token using either a client-side obtained oauth 2.
Resend box sign requestResends a signature request email to all outstanding signers.
Restore fileRestores a file that has been moved to the trash.
Restore file versionRestores a specific version of a file after it was deleted.
Restore folderRestores a folder that has been moved to the trash.
Restore web linkRestores a web link that has been moved to the trash.
Review files on legal hold policy assignmentGet a list of files with current file versions for a legal hold assignment.
Revoke access tokenRevoke an active access token, effectively logging a user out that has been previously authenticated.
Search for contentSearches for files, folders, web links, and shared files across the users content or across the entire enterprise.
Starts workflow based on request bodyInitiates a flow with a trigger type of `workflow manual start`.
Transfer owned foldersTransfers ownership of a specific folder (with id 0) from one user to another in the box cloud storage system.
Unassign legal hold policyRemove a legal hold from an item.
Unassign storage policyDelete a storage policy assignment.
Unassign taskDeletes a specific task assignment.
Update ai agentUpdates an ai agent.
Update all box skill cards on fileAn alternative method that can be used to overwrite and update all box skill metadata cards on a file.
Update collaborationUpdates a collaboration.
Update commentUpdate the message of a comment.
Update fileUpdates a file.
Update file requestUpdates a file request.
Update folderUpdates a folder.
Update groupUpdates a specific group.
Update group membershipUpdates a user's group membership.
Update legal hold policyUpdate legal hold policy.
Update retention policyUpdates a retention policy.
Update shared link on fileUpdates a shared link on a file.
Update shared link on folderUpdates a shared link on a folder.
Update shared link on web linkUpdates a shared link on a web link.
Update shield information barrier segment with specified idUpdate shield information barrier segment with specified id
Update slack integration mappingUpdates a [slack integration mapping](https://support.
Update storage policy assignmentUpdates a specific storage policy assignment.
Update taskUpdates a task.
Update task assignmentUpdates a task assignment.
Update teams integration mappingUpdates a [teams integration mapping](https://support.
Update terms of serviceUpdates a specific terms of service.
Update terms of service status for existing userUpdates the status for a terms of service for a user.
Update userUpdates a managed or app user in an enterprise.
Update webhookUpdates a webhook.
Update web linkUpdates a web link object.
Upload fileUploads a small file to box.
Upload file versionUpdate a file's content.
Upload part of fileUploads a chunk of a file for an upload session.

Connect Box MCP Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Box tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Add a shared link to Q2_financials.xlsx in the finance folder')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Connect Box API Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio_openai
Install the Composio SDK

Initialize Composio and Create Tool Router Session

python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
Import and initialize Composio client, then create a Tool Router session

Execute Box Tools via Tool Router with Your Agent

python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Add a shared link to the "Marketing Q2 Plan.docx" file in Box.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
Get tools from Tool Router session and execute Box actions with your Agent

Why Use Composio?

AI Native Box Integration

  • Supports both Box MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Box data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Box access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Box
  • Scoped, least privilege access to Box resources
  • Full audit trail of agent actions to support review and compliance

Use Box with any AI Agent Framework

Choose a Framework you want to connect Box with

Frequently Asked Questions

Do I need my own developer credentials to use Box with Composio?

No, you can get started immediately using Composio's built-in Box app. For production, we recommend configuring your own OAuth credentials.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free