# macbox

> macbox is an MCP server for developer tools. A cloud Mac that lets coding agents build, test and tap through iOS apps in the simulator. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** CLI, macOS
- **Website:** https://macbox.build
- **Repository:** https://github.com/opslane/macbox-agent
- **MCP Registry name:** io.github.opslane/macbox
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-16

## About

Coding agents running on Linux or in a cloud sandbox cannot run Xcode, and this service supplies a real Mac for that job. Tracked files go to a Mac mini running the latest Xcode, into a macOS VM used only by you that cannot reach other VMs or the provider's network. Only changed files are sent after the first run and the build cache stays, so later builds are quicker.

The MCP tools cover building for the simulator or macOS, running tests with one PASS or FAIL line each, taking screenshots, launching an app with a live browser link, and driving it with describe, tap, type, swipe, press_button and look. An optional mode adds Sentry's open-source MobileBuildMCP tools for LLDB debugging, Swift packages and simulator settings. Native Xcode projects, Swift packages, CocoaPods and XcodeGen work today; signing, TestFlight, React Native and Flutter do not yet.

Billing is prepaid at $0.05 per Mac minute in whole minutes, with jobs under a minute free and uploading, queueing and boot time free. New accounts start with $10, about 200 minutes. The plugin and npm package are MIT licensed while the service itself runs on the vendor's Macs.

## Features

- **Cloud Mac builds:** Run xcodebuild and tests on a Mac mini with the latest Xcode.
- **Simulator control:** Launch apps and tap, type, swipe and press buttons to check work.
- **Live link:** Watch and use the running app from a browser link.
- **Incremental sync:** Only changed files are sent and the build cache persists.
- **Isolated VM:** Each user gets their own macOS VM with no access to other VMs.
- **Debugging option:** LLDB tools via an optional Xcode mode.

## Good for

- Have an agent fix a layout bug and rerun iOS tests
- Build an iOS app from a Linux sandbox
- Screenshot a screen on a specific simulated iPhone
- Debug a crash with breakpoints from an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add macbox --env MACBOX_API_KEY='<MACBOX_API_KEY>' -- npx -y macbox
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "macbox": {
      "command": "npx",
      "args": [
        "-y",
        "macbox"
      ],
      "env": {
        "MACBOX_API_KEY": "<MACBOX_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "macbox": {
      "command": "npx",
      "args": [
        "-y",
        "macbox"
      ],
      "env": {
        "MACBOX_API_KEY": "<MACBOX_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "macbox": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "macbox"
      ],
      "env": {
        "MACBOX_API_KEY": "<MACBOX_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "macbox": {
      "command": "npx",
      "args": [
        "-y",
        "macbox"
      ],
      "env": {
        "MACBOX_API_KEY": "<MACBOX_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "macbox": {
      "command": "npx",
      "args": [
        "-y",
        "macbox"
      ],
      "env": {
        "MACBOX_API_KEY": "<MACBOX_API_KEY>"
      }
    }
  }
}
```

## Tools

- `build`: Build for the iOS simulator or macOS.
- `test`: Run tests on a fresh simulator with one PASS/FAIL line per test.
- `screenshot`: Launch the last build and return a picture.
- `run`: Launch the app, keep it running and return a live link.
- `describe`: Read what is on screen in the running app.
- `tap`: Tap an element in the running app.
- `type`: Type text in the running app.
- `swipe`: Swipe in the running app.
- `press_button`: Press a hardware button in the simulator.
- `look`: Look at the running app.
- `stop`: End the running app.
- `report_problem`: Tell the macbox team when something on their side is wrong.

## FAQ

### How is it priced?

$0.05 per Mac minute, prepaid, with jobs under a minute free and no subscription.

### What is supported today?

Native iOS apps via Xcode projects and workspaces, Swift packages, CocoaPods and XcodeGen.

### What is not supported yet?

Signing, TestFlight, React Native and Flutter.

### Is my code isolated?

Files go into your own macOS VM that only you use and that cannot reach other VMs.

### Is macbox free?

macbox is a paid product with a free trial.

### How do I add macbox to Claude Code?

Run this command in your terminal: claude mcp add macbox --env MACBOX_API_KEY='<MACBOX_API_KEY>' -- npx -y macbox

### What are the best alternatives to macbox?

The closest alternatives to macbox are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/macbox
