Skip to content
Back to search

mcp-server-box

Securely connect AI agents to your enterprise content in Box

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/box-community--mcp-server-box/badge.svg)](/listings/box-community--mcp-server-box)

HTML

<a href="/listings/box-community--mcp-server-box"><img src="/api/listings/box-community--mcp-server-box/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Clone the repository:

git clone https://github.com/box-community/mcp-server-box.git
cd mcp-server-box

Optional but recommended `uv` installation for virtual environment and dependency management:

Homebrew (macOS)

brew install uv

WinGet (Windows)

winget install --id=astral-sh.uv  -e

On macOS and Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

On Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Set up the virtual environment and install dependencies:

uv sync

Set environment variables:

Set the following environment variables for Box authentication in a `.env` file or your system environment.

For comprehensive authentication configuration options, see the [Authentication Guide](docs/authentication.md).

Using OAuth2.0 with a Box App

BOX_CLIENT_ID = YOUR_CLIENT_ID
BOX_CLIENT_SECRET = YOUR_CLIENT_SECRET
BOX_REDIRECT_URL = http://localhost:8000/callback

# MCP Server Authentication (for HTTP transports)
BOX_MCP_SERVER_AUTH_TOKEN = YOUR_BOX_MCP_SERVER_AUTH_TOKEN
OAUTH_PROTECTED_RESOURCES_CONFIG_FILE = .oauth-protected-resource.json

> **Note**: > - The `BOX_MCP_SERVER_AUTH_TOKEN` is used to authenticate the MCP client to the MCP server when using `--mcp-auth-type=token` (independent of Box authentication)

Run the MCP server in STDIO mode:

uv run src/mcp_server_box.py

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 155 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Box MCP Server
  2. > [!WARNING]
  3. > **This repository is discontinued and no longer maintained.**
  4. > Box now provides an officially supported hosted MCP server with the best experience and full functionality.
  5. > Please migrate to the hosted MCP server: **[Set up the Box MCP Server →](https://developer.box.com/guides/box-mcp/setup)**
  6. ## Quick Start
  7. ### Clone the repository:
  8. ```sh
  9. git clone https://github.com/box-community/mcp-server-box.git
  10. cd mcp-server-box
  11. ```
  12. ### Optional but recommended `uv` installation for virtual environment and dependency management:
  13. #### Homebrew (macOS)
  14. ```sh
  15. brew install uv
  16. ```
  17. #### WinGet (Windows)
  18. ```sh
  19. winget install --id=astral-sh.uv -e
  20. ```
  21. #### On macOS and Linux
  22. ```sh
  23. curl -LsSf https://astral.sh/uv/install.sh | sh
  24. ```
  25. #### On Windows
  26. ```sh
  27. powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  28. ```
  29. ### Set up the virtual environment and install dependencies:
  30. ```sh
  31. uv sync
  32. ```
  33. ### Set environment variables:
  34. Set the following environment variables for Box authentication in a `.env` file or your system environment.
  35. For comprehensive authentication configuration options, see the [Authentication Guide](docs/authentication.md).
  36. #### Using OAuth2.0 with a Box App
  37. ```
  38. BOX_CLIENT_ID = YOUR_CLIENT_ID
  39. BOX_CLIENT_SECRET = YOUR_CLIENT_SECRET
  40. BOX_REDIRECT_URL = http://localhost:8000/callback
  41. # MCP Server Authentication (for HTTP transports)
  42. BOX_MCP_SERVER_AUTH_TOKEN = YOUR_BOX_MCP_SERVER_AUTH_TOKEN
  43. OAUTH_PROTECTED_RESOURCES_CONFIG_FILE = .oauth-protected-resource.json
  44. ```
  45. > **Note**:
  46. > - The `BOX_MCP_SERVER_AUTH_TOKEN` is used to authenticate the MCP client to the MCP server when using `--mcp-auth-type=token` (independent of Box authentication)
  47. ### Run the MCP server in STDIO mode:
  48. ```sh
  49. uv run src/mcp_server_box.py
  50. ```
  51. ## Box Community MCP Server Tools
  52. Below is a summary of the available tools:
  53. | Tools available | Description |
  54. |--------------------------|--------------------------------------------------|
  55. | [box_tools_ai](docs/box_tools_ai.md) | AI-powered file and hub queries |
  56. | [box_tools_collaboration](docs/box_tools_collaboration.md) | Manage file/folder collaborations |
  57. | [box_tools_docgen](docs/box_tools_docgen.md) | Document generation and template management |
  58. | [box_tools_files](docs/box_tools_files.md) | File operations (read, upload, download) |
  59. | [box_tools_folders](docs/box_tools_folders.md) | Folder operations (list, create, delete, update) |
  60. | [box_tools_generic](docs/box_tools_generic.md) | Generic Box API utilities |
  61. | [box_tools_groups](docs/box_tools_groups.md) | Group management and queries |
  62. | [box_tools_metadata](docs/box_tools_metadata.md) | Metadata template and instance management |
  63. | [box_tools_search](docs/box_tools_search.md) | Search files and folders |
  64. | [box_tools_shared_links](docs/box_tools_shared_links.md) | Shared link management for files/folders/web-links|
  65. | [box_tools_tasks](docs/box_tools_tasks.md) | Task and task assignment management |
  66. | [box_tools_users](docs/box_tools_users.md) | User management and queries |
  67. | [box_tools_web_link](docs/box_tools_web_link.md) | Web link creation and management |
  68. ## Box Community MCP Server Operations Details
  69. ### Command line interface parameters
  70. To run the MCP server with specific configurations, you can use the following command line parameters:
  71. ```sh
  72. uv run src/mcp_server_box.py --help
  73. ```
  74. ```
  75. usage: mcp_server_box.py [-h] [--transport {stdio,sse,http}] [--host HOST] [--port PORT] [--mcp-auth-type {oauth,token,none}] [--box-auth-type {oauth,ccg,jwt,mcp_client}]
  76. Box Community MCP Server
  77. options:
  78. -h, --help show this help message and exit
  79. --transport {stdio,sse,http}
  80. Transport type (default: stdio)
  81. --host HOST Host for SSE/HTTP transport (default: localhost)
  82. --port PORT Port for SSE/HTTP transport (default: 8005)
  83. --mcp-auth-type {oauth,token,none}
  84. Authentication type for MCP server (default: token)
  85. --box-auth-type {oauth,ccg,jwt,mcp_client}
  86. Authentication type for Box API (default: oauth)
  87. ```
  88. For detailed information about authentication types, configurations, and use cases, see the [Authentication Guide](docs/authentication.md).
  89. ### Claude Desktop Configuration
  90. #### STDIO mode
  91. Edit your `claude_desktop_config.json`:
  92. ```code ~/Library/Application\ Support/Claude/claude_desktop_config.json```
  93. Add the configuration:
  94. ```json
  95. {
  96. "mcpServers": {
  97. "mcp-server-box": {
  98. "command": "uv",
  99. "args": [
  100. "--directory",
  101. "/path/to/mcp-server-box",
  102. "run",
  103. "src/mcp_server_box.py"
  104. ]
  105. }
  106. }
  107. }
  108. ```
  109. Restart Claude if it is running.
  110. #### HTTP Mode
  111. Assuming your MCP server is running on `https://mcp.myserver.com/mcp`
  112. 1. Go to Claude -> Settings -> Connectors
  113. 2. Select `Add custom connector`
  114. 3. Configurations:
  115. 1. Give it a name
  116. 2. Enter the URL e.g. `https://mcp.myserver.com/mcp`
  117. 3. Optionally enter the `client id` and `client secret`
  118. 4. Click add
  119. 5. Click connect. The OAuth flow should start. Complete the flow
  120. 6. Back in Claude, click Configure. You should see all the tools available.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.