Log inSubmit server
ParallelSandbox logo

ParallelSandbox

Connects AI tools to remote Linux boxes with sandbox, log, and local file transfer tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install ParallelSandbox

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "parallelsandbox-2": {
      "command": "npx",
      "args": [
        "-y",
        "parallelsandbox-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

ParallelSandbox MCP server connects MCP clients to remote Linux boxes through the ParallelSandbox MCP endpoint. It exposes sandbox and log tools, while its stdio adapter adds local `sandbox_sync` and `sandbox_pull` for moving project files between the client machine and a box. OAuth sign-in opens in a browser by default, with an existing API key supported as an alternative. Reach for it when an agent needs a remote coding environment, browser and Docker access, logs, screenshots, or controlled file transfer.

Use cases

  • Run coding tasks in a remote Linux box
  • Upload an uncommitted project for remote execution
  • Download build artifacts or generated files
  • Inspect sandbox logs from an MCP client
  • Let a person take over a remote browser session

Key features

  • OAuth sign-in with browser-assisted approval
  • Remote sandbox and log tools
  • Local project sync without committing
  • File and directory pull from a box
  • Dry runs, exclusions, pruning, and progress reporting
  • Optional existing API-key authentication

Tools1

What ParallelSandbox lets your agent do. Expand a tool for its parameters.

Verified live~57 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 38d

What it can do

From the 1 tool this server returned when we ran it.

Read-only tools · 1
Network at startup4 connections
Files written at startup1
Install scriptsNone
npm provenanceNot published
Package age30 days
Maintainers1

Observed 2026-10-17 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · parallelsandbox-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads2.4kPackage downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Tools exposed1Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How ParallelSandbox works

What ParallelSandbox MCP server does

ParallelSandbox MCP server gives an MCP-compatible coding agent access to remote Linux boxes managed by ParallelSandbox. The remote environment supports the capabilities described by the service, including Docker, a browser, screenshots, logs, and human takeover. The adapter exposes the service's sandbox_* and logs_* tools through the MCP endpoint.

The package is a local stdio adapter rather than a separate sandbox implementation. It connects to https://mcp.parallelsandbox.com/mcp by default and adds two operations that need access to the developer's machine: sandbox_sync uploads a working directory without requiring a commit, and sandbox_pull downloads files or directories from a box.

How it works

Start the adapter with npx -y parallelsandbox-mcp, then configure an MCP client to launch it as a stdio server. On the first connection, parallelsandbox_connect reports sign-in status and opens a browser for OAuth. If sign-in is still pending, the tool returns a link for the user to approve; call it again after approval. Clients that do not refresh their tool list may need to reconnect once authentication finishes.

Authentication state is stored under ~/.parallelsandbox with restrictive file permissions and is shared across conversations using the same endpoint. Existing API-key configurations can bypass OAuth. The adapter also serializes token refreshes with a file lock.

Setup and configuration

Run:

Terminal
npx -y parallelsandbox-mcp

For Claude Code, add it with:

Terminal
claude mcp add parallelsandbox -- npx -y parallelsandbox-mcp

Set PARALLELSANDBOX_NO_BROWSER=1 when the sign-in URL should be returned without opening a browser. PARALLELSANDBOX_API_KEY can provide an existing key. PARALLELSANDBOX_AUTH_DIR changes where OAuth files and locks are stored. Development deployments require both PARALLELSANDBOX_MCP_URL and PARALLELSANDBOX_API_URL to be set to their development addresses.

Tools and capabilities

ParallelSandbox MCP server provides:

  • parallelsandbox_connect for starting or checking authentication.
  • Remote sandbox_* tools for working with boxes.
  • Remote logs_* tools for inspecting service logs.
  • sandbox_sync for comparing a local project with a box and uploading changed files.
  • sandbox_pull for downloading a file or directory into a local path.

Sync supports dry runs, exclusions, pruning stale remote files, progress reporting, size limits, selected Git revisions, and optional initialized submodules. It omits common generated or dependency directories such as .git, node_modules, build output, and coverage data. Pull can merge extracted contents into an existing directory or replace an eligible directory with clean.

Limitations and notes

The local sync and pull operations are implemented by the stdio adapter and are unavailable when connecting directly over plain HTTP; those remote calls return errors. Sync paths must be absolute or resolve relative to the adapter's working directory, which may differ from the agent's working directory. Uploads over 100 MB are blocked unless a larger maxMB value is supplied.

Files deleted locally remain in the box unless pruning is requested. sandbox_pull merges by default, and its clean mode is refused for Git checkouts, home directories, the adapter's working directory, and their parents. A hand-off copy used for pulling is deleted from ParallelSandbox after about a day. Authentication waits five minutes before a cancelled or unfinished sign-in must be retried.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about ParallelSandbox

ParallelSandbox is an MCP server that connects AI clients to remote Linux boxes through sandbox and log tools. Its stdio adapter also provides local sandbox_sync and sandbox_pull operations, allowing agents to upload working directories without committing and download files or directories back to the client machine.

Run `npx -y parallelsandbox-mcp` and configure your MCP client to launch it as a stdio server. Claude Code can use `claude mcp add parallelsandbox -- npx -y parallelsandbox-mcp`. No API key is needed when using the browser-based OAuth sign-in.

Yes, the adapter documents Cursor-specific end-of-turn hook behavior for review requests and can run as a standard stdio MCP server. Configure Cursor to start `npx -y parallelsandbox-mcp`; complete the browser OAuth flow, then reconnect if the client does not reload tools.

Yes, `sandbox_sync` uploads differences from a local directory without requiring a commit. In a Git working tree it includes tracked and eligible untracked files, skips ignored files and `.git`, and can report changes with `dryRun` before sending anything.

Yes, clients can connect directly to `https://mcp.parallelsandbox.com/mcp` over HTTP and authenticate with OAuth. However, `sandbox_sync` and `sandbox_pull` are unavailable over plain HTTP because those operations read and write files on the local machine.

Related MCP servers

All in Cloud Platforms All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewParallelSandbox AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/parallelsandbox-2?style=directory)](https://allmcps.com/mcp/parallelsandbox-2)
HTML Embed
<a href="https://allmcps.com/mcp/parallelsandbox-2"><img src="https://allmcps.com/api/badge/parallelsandbox-2?style=directory" alt="ParallelSandbox on AllMCPs" /></a>