Can I use Box as a CLI?

Yes. KosmoKrator exposes a Box CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Box through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Box tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Box credentials stored?

Box credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Box MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

other

Box MCP, CLI, and Lua Integration for AI Agents

Box integration docs for AI agents: MCP gateway setup, Box CLI commands, Lua API reference, credentials, and function schemas.

10 functions 6 read 4 write Manual OAuth token auth

Submit Box feedback View package source

Box for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: box
route_slug: box
package: box
auth_strategy: oauth2_manual_token Manual OAuth token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Box CLIHeadless setup and direct function calls. Box MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Box MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Box.

Claude Code Box MCP setup for Claude Code. Cursor Box MCP setup for Cursor. Codex Box MCP setup for Codex. OpenAI Agents Box MCP setup for OpenAI Agents SDK. Claude Agent SDK Box MCP setup for Claude Agent SDK. Vercel AI SDK Box MCP setup for Vercel AI SDK. LangChain Box MCP setup for LangChain. LangGraph Box MCP setup for LangGraph. CrewAI Box MCP setup for CrewAI. MCP clients Box MCP setup for Generic MCP Clients.

Box CLI Matrix

Use these pages for direct Box CLI workflows in scripts, CI, cron, and agent wrappers.

CI Box CLI for CI. Cron Jobs Box CLI for cron jobs. Shell Scripts Box CLI for shell scripts. Headless Automation Box CLI for headless automation. Coding Agents Box CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`box.box_list_files`	Read `read`	3	List files and folders in a Box folder. Returns item names, IDs, types (file or folder), sizes, and modification dates. Use folder ID "0" for the root folder.
`box.box_get_file`	Read `read`	1	Get metadata for a Box file by ID. Returns the file name, size, type, created/modified dates, parent folder, and shared link info.
`box.box_upload_file`	Write `write`	3	Upload a file to Box. Provide the file name, content, and optionally a parent folder ID (defaults to root). Returns the uploaded file metadata.
`box.box_download_file`	Read `read`	1	Download a file from Box by its ID. Returns the raw file contents. Use this to retrieve file data for processing.
`box.box_delete_file`	Write `write`	1	Delete a file from Box by its ID. This action moves the file to the trash. Use with caution — deleted files can be restored from the trash within the retention period.
`box.box_create_folder`	Write `write`	2	Create a new folder in Box. Provide a folder name and optionally a parent folder ID (defaults to root). Returns the new folder metadata.
`box.box_get_folder`	Read `read`	1	Get metadata for a Box folder by ID. Returns the folder name, size, created/modified dates, parent folder, and item counts. Use "0" for root.
`box.box_share_file`	Write `write`	4	Create a shared link for a Box file. By default creates an open link. Optionally configure access level, password protection, and expiration.
`box.box_search`	Read `read`	3	Search for files and folders in Box. Returns matching items with names, IDs, types, and paths. Useful for finding files by name or content.
`box.box_get_current_user`	Read `read`	0	Get information about the currently authenticated Box user. Returns user name, email, login, and account details.