KosmoKrator

other

Box MCP Integration for Claude Code

Connect Box to Claude Code through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

10 functions 6 read 4 write Manual OAuth token auth
Submit Box feedback View package source

Connect Box to Claude Code

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

Box MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

{
  "mcpServers": {
    "kosmokrator-box": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=box",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=box --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Box instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Box Tools Visible to Claude Code

Claude Code sees stable MCP tool names generated from the Box integration catalog.

MCP toolSource functionTypeDescription
integration__box__box_list_files box.box_list_files Read 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.
integration__box__box_get_file box.box_get_file Read Get metadata for a Box file by ID. Returns the file name, size, type, created/modified dates, parent folder, and shared link info.
integration__box__box_upload_file box.box_upload_file Write Upload a file to Box. Provide the file name, content, and optionally a parent folder ID (defaults to root). Returns the uploaded file metadata.
integration__box__box_download_file box.box_download_file Read Download a file from Box by its ID. Returns the raw file contents. Use this to retrieve file data for processing.
integration__box__box_delete_file box.box_delete_file Write 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.
integration__box__box_create_folder box.box_create_folder Write Create a new folder in Box. Provide a folder name and optionally a parent folder ID (defaults to root). Returns the new folder metadata.
integration__box__box_get_folder box.box_get_folder Read 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.
integration__box__box_share_file box.box_share_file Write Create a shared link for a Box file. By default creates an open link. Optionally configure access level, password protection, and expiration.
integration__box__box_search box.box_search Read Search for files and folders in Box. Returns matching items with names, IDs, types, and paths. Useful for finding files by name or content.
integration__box__box_get_current_user box.box_get_current_user Read Get information about the currently authenticated Box user. Returns user name, email, login, and account details.

Related Box Pages

Box CLIUse direct JSON commands instead of MCP discovery. Box MCPFull gateway reference and MCP tool names. KosmoKrator for Claude CodeClient-level gateway setup.