# ShareBox

Hosts small web utilities created by your AI assistant on your private ShareBox server, letting you distribute them to teammates via Google sign-in.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 29
- Author: zalaso
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zalaso/sharebox/tree/HEAD/packages/cli
- Updated: 2026-10-18
- HTML: https://affpapa.org/en/nevibecode/mcp/sharebox

## What it does

The server links coding assistants with an on-premise ShareBox setup using `sharebox-cli`. Once connected, the model can generate mini apps and manage project permissions for specific mailboxes or entire Google Workspace accounts. Every hosted app operates inside an isolated sandbox with dedicated storage.

Available actions include `sharebox_publish`, `sharebox_share`, `sharebox_rollback`, and the bundled guide resource. Destructive actions are excluded by design. Clearing out a project requires terminal access via `sharebox delete <tool> --yes` to prevent models from destroying stored files.

Running the toolchain requires Node.js version 20 or higher alongside an accessible ShareBox host. Without valid `SHAREBOX_URL` and `SHAREBOX_TOKEN` parameters, the agent will fail to dispatch builds.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SHAREBOX_URL`, `SHAREBOX_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SHAREBOX_URL=<SHAREBOX_URL> --env SHAREBOX_TOKEN=<SHAREBOX_TOKEN> --transport stdio cli -- npx -y sharebox-cli
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add cli --env SHAREBOX_URL=<SHAREBOX_URL> --env SHAREBOX_TOKEN=<SHAREBOX_TOKEN> -- npx -y sharebox-cli
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cli": {
            "command": "npx",
            "args": [
                "-y",
                "sharebox-cli"
            ],
            "env": {
                "SHAREBOX_URL": "<SHAREBOX_URL>",
                "SHAREBOX_TOKEN": "<SHAREBOX_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cli": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "sharebox-cli"
            ],
            "env": {
                "SHAREBOX_URL": "<SHAREBOX_URL>",
                "SHAREBOX_TOKEN": "<SHAREBOX_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SHAREBOX_URL=<SHAREBOX_URL> -e SHAREBOX_TOKEN=<SHAREBOX_TOKEN> cli npx -y sharebox-cli
```
Replace <…> with your own values

## When to use it
- deploy agent-crafted web apps directly to internal infrastructure
- grant project access to corporate Google Workspace emails
- revert broken deployments while preserving application storage
- pass external API credentials into tool sandboxes securely

## Example prompts
- Create a team holiday schedule viewer and deploy it to ShareBox.
- /mcp__sharebox__build_tool idea="Invoice generator" share_with="billing@example.com"
- List all tools currently hosted on my ShareBox instance.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md