box
Work with your Box content directly from Claude Code — search files, organize folders, collaborate with your team, and use Box AI to answer
Open source Open in the app JSON README (API)
About
Work with your Box content directly from Claude Code — search files, organize folders, collaborate with your team, and use Box AI to answer questions, summarize documents, and extract data without leaving your workflow.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- box
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 7
- Forks
- 5
- Open pull requests
- 1
- Last push
- 2026-09-04T16:55:56Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-09-08 16:04:04
- Origin id
box/box-for-ai/box
README
# Box Agent Skills Agent Skills to help developers using AI agents work with Box. Whether you're building Box integrations in code, working with Box content via MCP tools, configuring webhooks, or using Box AI retrieval — this plugin gives your assistant the context it needs to do it right. The skills in this repo follow the [Agent Skills](https://agentskills.io/) format and can also be installed as a plugin for platforms like Codex, [Cursor](https://cursor.com), [Claude](https://claude.com), including Claude Code and Cowork, and [Kiro](https://kiro.dev). ## Installation ### As an Agent Skill ```bash npx skills add box/skills ``` Check out the latest and full list of skills [here](https://skills.sh/box/skills). ### As a Platform Plugin This repo can also be installed as a plugin for supported platforms. MCP connection and OAuth setup vary by platform — see the setup guide for your platform below. The root `plugin.json` and `mcp.json` follow the [Agent Plugins v1.0.0 specification](https://agent-plugins.org/specification). The portable MCP configuration declares the Box MCP endpoint; authentication remains managed by each client. Do not add credentials to this repository's root `mcp.json`; configure them only in your client's settings. | Platform | Setup guide | |---|---| | Codex | [`.codex-plugin/README.md`](.codex-plugin/README.md) | | Cursor | [`.cursor-plugin/README.md`](.cursor-plugin/README.md) | | Claude Code | [`.claude-plugin/README.md`](.claude-plugin/README.md) | | Kiro | [Install as a Kiro Power](#kiro-power) | ### Kiro Power In Kiro, open the Powers panel and install the Box Power. If it is not shown in the catalog, select **Add Custom Power** → **Import power from GitHub** and enter `https://github.com/box/skills`. The bundled skills work in both Kiro IDE and CLI. Note that the Box MCP Server currently does not support Dynamic Client Registration, so credential-free Power authentication is not yet available in Kiro IDE. Kiro CLI users can configure Box OAuth client credentials in their user MCP settings; future managed OAuth integration or confidential-client OAuth support in the IDE can enable the bundled MCP connection there. ## Usage Skills are automatically available once installed. The agent will use them when relevant tasks are detected. Here are some example prompts: ### Implement Box content workflows `Add Box file upload to my app` `Create a shared link for this folder` `Set up Box webhooks for new file events` ### Build document-driven flows `Search my Box account for invoices` `Use Box AI to classify documents` `Wire webhooks to process new uploads` ### Troubleshoot integrations `Debug 401 errors with my Box JWT auth` `Fix webhook signature verification` ## Skill Structure The Box skill follows the [Agent Skills Open Standard](https://agentskills.io/): - `SKILL.md` - Skill manifest with frontmatter, routing table, workflow steps, and guardrails - `references/` - Individual reference files (auth, content workflows, MCP tool patterns, AI/retrieval, etc.) ## Prerequisites - **Box CLI** (optional) — Install from [developer.box.com/guides/cli](https://developer.box.com/guides/cli) for CLI-first verification. - **BOX_ACCESS_TOKEN** (optional) — For direct REST verification when Box CLI is unavailable. ## Quick Verification Preferred order for agent tooling is MCP first, Box CLI second, and direct REST only as a last-resort fallback. ```bash # With Box CLI installed and authenticated: box users:get me --json box folders:items 0 --json --max-items 5 # Last-resort fallback (for sessions where MCP/CLI are unavailable): export BOX_ACCESS_TOKEN="your-token" curl -sS -H "Authorization: Bearer $BOX_ACCESS_TOKEN" -H "Accept: application/json" "https://api.box.com/2.0/folders/0" ``` ## Contributing Skills follow the [Agent Skills specification](https://agentskills.io). The Box skill is a directory with a `SKILL.md` file containing YAML frontmatter and markdown instructions, plus a `references/` directory for feature-specific deep dives. ## License MIT ## Privacy and Support - [Box Privacy Policy](https://www.box.com/legal/privacypolicy) - [Box Support](https://support.box.com/)