macbox MCP server

Q: How do I add macbox MCP to Claude Code?

Run `claude mcp add --env 'MACBOX_API_KEY= ' macbox-agent -- npx -y macbox` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add macbox MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ VerifiedCommit Oct 31, 2026

opslane/macbox-agent · javascript · MIT

Allows AI agents to build, test, and interact with native iOS apps on a cloud-based Mac mini using an iOS simulator.

Also known as opslane/macbox-agent, macbox-agent

stdio Developer Tools

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: —
Latest version: 0.6.2
Last commit: Oct 31, 2026
License: MIT

What is macbox MCP?

macbox allows AI agents to build, test, and interact with native iOS apps on a cloud-based Mac mini using an iOS simulator.

Summary generated from the project's README

About macbox MCP server

macbox provides a cloud-based Mac mini environment that allows AI agents to develop and interact with native iOS applications. This service is designed for developers using MCP clients like Claude Code, Cursor, or Codex, enabling them to run mobile development workflows from any machine, including Linux systems or cloud sandboxes. The server connects your agent to a dedicated macOS virtual machine where it can execute xcodebuild commands and run XCTest or UI tests.

Users can manage the development lifecycle through specific tools such as build, test, screenshot, and run. The agent can interact with the iOS simulator using commands to tap, type, swipe, and look at the screen. For real-time monitoring, every running application provides a browser link for manual inspection. Access requires a MACBOX_API_KEY or a login via the macbox CLI. The service operates on a per-minute billing model at $0.05 per minute, though jobs lasting under sixty seconds are free.

What you can do with it

1Automated iOS app testingAsk your agent to run XCTest or UI tests on a fresh simulator and report the results.
2Visual verification of buildsHave the agent take a picture of the application after the latest build to check the UI.
3Interactive UI navigationInstruct the agent to navigate through the app by simulating human gestures like swiping or tapping.
4Remote mobile developmentBuild and run native Swift or CocoaPods projects from a Linux-based cloud agent.

Written from the project's README. Every use case is checked against a quote from it.

How to install macbox MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --env 'MACBOX_API_KEY=<YOUR_MACBOX_API_KEY>' macbox-agent -- npx -y macbox

~/.cursor/mcp.json

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

.vscode/mcp.json

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

$ code --add-mcp '{"name":"macbox-agent","type":"stdio","command":"npx","args":["-y","macbox"],"env":{"MACBOX_API_KEY":"<YOUR_MACBOX_API_KEY>"}}'

claude_desktop_config.json

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

$ codex mcp add macbox-agent --env 'MACBOX_API_KEY=<YOUR_MACBOX_API_KEY>' -- npx -y macbox

~/.codex/config.toml

[mcp_servers.macbox-agent]
command = "npx"
args = ["-y", "macbox"]

[mcp_servers.macbox-agent.env]
MACBOX_API_KEY = "<YOUR_MACBOX_API_KEY>"

$ gemini mcp add -s user -e 'MACBOX_API_KEY=<YOUR_MACBOX_API_KEY>' macbox-agent npx -- -y macbox

~/.gemini/settings.json

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

Set 1 environment variable before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

MACBOX_API_KEYSecret
Your macbox API key (mbx_...). Optional if you ran `macbox login`.

Name	Description
MACBOX_API_KEY	Your macbox API key (mbx_...). Optional if you ran `macbox login`.	Secret

Automated checks

Ran Nov 14, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachableopslane/macbox-agent is public and reachablegithub.com/opslane/macbox-agent ↗Pass
Package names this repository as its sourcemacbox names opslane/macbox-agent as sourcenpmjs.com/package/macbox ↗Pass
Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
Commit or release in the last yearLast commit or release 2026-10-31github.com/opslane/macbox-agent ↗Pass
OpenSSF ScorecardNot checked
Package name not close to a popular packageNo popular package one edit away from macboxPass
No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
Destructive tools are labelledNot checked
Remote endpoint answers the MCP handshakeNot checked

README

View on GitHub

macbox

A real Mac for your coding agent. macbox lets Claude Code, Codex, Cursor, or any MCP client build, test, run, and tap through native iOS apps on a real Mac in the cloud, from any machine, including Linux boxes and cloud agent sandboxes.

Build and test: xcodebuild and your XCTest and UI tests, on a Mac mini running the latest Xcode. Your agent gets the results and the error lines.
Run and drive the app: launch it on the iOS simulator, read what's on screen, tap, type, and swipe, so your agent can check its own work.
Watch live: every running app gets a browser link where you can watch and use it too.

Pay per Mac minute, whole minutes only: $0.05, and a job under a minute is free. Get access and free credit at macbox.build.

Set up

The quickest way: tell your agent

Set up macbox by following https://api.macbox.build/guide/

Or pick your client:

Claude Code (plugin: skill + MCP tools)

claude plugin marketplace add opslane/macbox-agent
claude plugin install macbox@macbox

Codex (plugin: skill), with the macbox CLI installed (below):

codex plugin marketplace add opslane/macbox-agent
codex plugin add macbox@macbox

Any MCP client (Codex, Cursor, Claude Desktop, VS Code, ...), with Node 18+:

{
  "mcpServers": {
    "macbox": { "command": "npx", "args": ["-y", "macbox", "mcp"] }
  }
}

The CLI (macOS or Linux):

curl -fsSL https://api.macbox.build/install.sh | sh
macbox login
macbox setup      # installs the skill for Claude Code and Codex, and notes in CLAUDE.md / AGENTS.md

Just the skill (Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and more):

npx skills add opslane/macbox-agent

If the CLI isn't set up yet, the skill sends your agent to the guide to install it.

What your agent gets

MCP tool	CLI	What it does
`build`	`macbox build`	Build for the iOS simulator (or macOS, for a Mac app)
`test`	`macbox test`	Run tests on a fresh simulator; one PASS/FAIL line per test
`screenshot`	`macbox screenshot`	Launch the last build and return a picture
`run`	`macbox run`	Launch the app and keep it running; returns a live link
`describe`, `tap`, `type`, `swipe`, `press_button`, `look`	`macbox ui ...`	Use the running app like a person
`stop`	`macbox stop`	End the running app
`report_problem`	`macbox feedback`	Tell the macbox team when something on our side is wrong

For deeper work there is also macbox mcp --xcode: Sentry's open-source MobileBuildMCP Xcode tools (LLDB debugging, Swift packages, simulator settings), running on the macbox Mac.

How it works

macbox sends the files git tracks (never .env files unless you ask) to one Mac mini, into your own macOS VM that only you use and that can't reach other VMs or our network. Only changed files are sent after the first time, and the build cache stays, so the second build is fast. Native iOS apps work today: Xcode projects and workspaces, Swift packages, CocoaPods, XcodeGen. Not yet: signing, TestFlight, React Native, Flutter.

Full guide: https://api.macbox.build/guide/ · Questions: Discord

This repository

The open parts of macbox: the Claude Code plugin (.claude-plugin/, skills/, .mcp.json), the macbox npm package (npm/, which downloads the CLI from api.macbox.build and checks it against the published SHA256SUMS), and the MCP Registry entry (server.json). The macbox service itself runs on our Macs.

MIT licensed.

Read full README

macbox MCP questions

How do I add macbox MCP to Claude Code?

Run claude mcp add --env 'MACBOX_API_KEY=<YOUR_MACBOX_API_KEY>' macbox-agent -- npx -y macbox in your terminal. Add --scope user to make it available in every project.

How do I add macbox MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What can an AI agent do with macbox?

An agent can build for the iOS simulator, run tests, take screenshots, and interact with the app via tapping, typing, and swiping.

How much does macbox cost?

The service uses a pay-per-minute model at $0.05 per Mac minute, and any job lasting under a minute is free.

Does macbox support React Native or Flutter?

Currently, macbox does not support signing, TestFlight, React Native, or Flutter.

How do I authenticate with macbox?

You can log in using the macbox CLI or by setting the MACBOX_API_KEY environment variable.

Facts

Nov 14, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 0.6.2
Last commit: Oct 31, 2026
License: MIT
Transport: stdio
Package: macbox

opslane ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/opslane/macbox-agent.svg)](https://hostedmcp.org/servers/opslane/macbox-agent/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

macbox MCP server

✓ VerifiedCommit Oct 31, 2026

opslane/macbox-agent · javascript · MIT

Allows AI agents to build, test, and interact with native iOS apps on a cloud-based Mac mini using an iOS simulator.

Also known as opslane/macbox-agent, macbox-agent

stdio Developer Tools

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: —
Latest version: 0.6.2
Last commit: Oct 31, 2026
License: MIT

What is macbox MCP?

macbox allows AI agents to build, test, and interact with native iOS apps on a cloud-based Mac mini using an iOS simulator.

Summary generated from the project's README

About macbox MCP server

What you can do with it

1Automated iOS app testingAsk your agent to run XCTest or UI tests on a fresh simulator and report the results.
2Visual verification of buildsHave the agent take a picture of the application after the latest build to check the UI.
3Interactive UI navigationInstruct the agent to navigate through the app by simulating human gestures like swiping or tapping.
4Remote mobile developmentBuild and run native Swift or CocoaPods projects from a Linux-based cloud agent.

Written from the project's README. Every use case is checked against a quote from it.

How to install macbox MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --env 'MACBOX_API_KEY=<YOUR_MACBOX_API_KEY>' macbox-agent -- npx -y macbox

~/.cursor/mcp.json

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

.vscode/mcp.json

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

$ code --add-mcp '{"name":"macbox-agent","type":"stdio","command":"npx","args":["-y","macbox"],"env":{"MACBOX_API_KEY":"<YOUR_MACBOX_API_KEY>"}}'

claude_desktop_config.json

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

$ codex mcp add macbox-agent --env 'MACBOX_API_KEY=<YOUR_MACBOX_API_KEY>' -- npx -y macbox

~/.codex/config.toml

[mcp_servers.macbox-agent]
command = "npx"
args = ["-y", "macbox"]

[mcp_servers.macbox-agent.env]
MACBOX_API_KEY = "<YOUR_MACBOX_API_KEY>"

$ gemini mcp add -s user -e 'MACBOX_API_KEY=<YOUR_MACBOX_API_KEY>' macbox-agent npx -- -y macbox

~/.gemini/settings.json

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

Set 1 environment variable before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

MACBOX_API_KEYSecret
Your macbox API key (mbx_...). Optional if you ran `macbox login`.

Name	Description
MACBOX_API_KEY	Your macbox API key (mbx_...). Optional if you ran `macbox login`.	Secret

Automated checks

Ran Nov 14, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachableopslane/macbox-agent is public and reachablegithub.com/opslane/macbox-agent ↗Pass
Package names this repository as its sourcemacbox names opslane/macbox-agent as sourcenpmjs.com/package/macbox ↗Pass
Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
Commit or release in the last yearLast commit or release 2026-10-31github.com/opslane/macbox-agent ↗Pass
OpenSSF ScorecardNot checked
Package name not close to a popular packageNo popular package one edit away from macboxPass
No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
Destructive tools are labelledNot checked
Remote endpoint answers the MCP handshakeNot checked

README

View on GitHub

macbox

Build and test: xcodebuild and your XCTest and UI tests, on a Mac mini running the latest Xcode. Your agent gets the results and the error lines.
Run and drive the app: launch it on the iOS simulator, read what's on screen, tap, type, and swipe, so your agent can check its own work.
Watch live: every running app gets a browser link where you can watch and use it too.

Pay per Mac minute, whole minutes only: $0.05, and a job under a minute is free. Get access and free credit at macbox.build.

Set up

The quickest way: tell your agent

Set up macbox by following https://api.macbox.build/guide/

Or pick your client:

Claude Code (plugin: skill + MCP tools)

claude plugin marketplace add opslane/macbox-agent
claude plugin install macbox@macbox

Codex (plugin: skill), with the macbox CLI installed (below):

codex plugin marketplace add opslane/macbox-agent
codex plugin add macbox@macbox

Any MCP client (Codex, Cursor, Claude Desktop, VS Code, ...), with Node 18+:

{
  "mcpServers": {
    "macbox": { "command": "npx", "args": ["-y", "macbox", "mcp"] }
  }
}

The CLI (macOS or Linux):

curl -fsSL https://api.macbox.build/install.sh | sh
macbox login
macbox setup      # installs the skill for Claude Code and Codex, and notes in CLAUDE.md / AGENTS.md

Just the skill (Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and more):

npx skills add opslane/macbox-agent

If the CLI isn't set up yet, the skill sends your agent to the guide to install it.

What your agent gets

MCP tool	CLI	What it does
`build`	`macbox build`	Build for the iOS simulator (or macOS, for a Mac app)
`test`	`macbox test`	Run tests on a fresh simulator; one PASS/FAIL line per test
`screenshot`	`macbox screenshot`	Launch the last build and return a picture
`run`	`macbox run`	Launch the app and keep it running; returns a live link
`describe`, `tap`, `type`, `swipe`, `press_button`, `look`	`macbox ui ...`	Use the running app like a person
`stop`	`macbox stop`	End the running app
`report_problem`	`macbox feedback`	Tell the macbox team when something on our side is wrong

For deeper work there is also macbox mcp --xcode: Sentry's open-source MobileBuildMCP Xcode tools (LLDB debugging, Swift packages, simulator settings), running on the macbox Mac.

How it works

Full guide: https://api.macbox.build/guide/ · Questions: Discord

This repository

MIT licensed.

Read full README

macbox MCP questions

How do I add macbox MCP to Claude Code?

Run claude mcp add --env 'MACBOX_API_KEY=<YOUR_MACBOX_API_KEY>' macbox-agent -- npx -y macbox in your terminal. Add --scope user to make it available in every project.

How do I add macbox MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What can an AI agent do with macbox?

An agent can build for the iOS simulator, run tests, take screenshots, and interact with the app via tapping, typing, and swiping.

How much does macbox cost?

The service uses a pay-per-minute model at $0.05 per Mac minute, and any job lasting under a minute is free.

Does macbox support React Native or Flutter?

Currently, macbox does not support signing, TestFlight, React Native, or Flutter.

How do I authenticate with macbox?

You can log in using the macbox CLI or by setting the MACBOX_API_KEY environment variable.

Facts

Nov 14, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 0.6.2
Last commit: Oct 31, 2026
License: MIT
Transport: stdio
Package: macbox

opslane ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/opslane/macbox-agent.svg)](https://hostedmcp.org/servers/opslane/macbox-agent/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

macbox MCP server

What is macbox MCP?

About macbox MCP server

What you can do with it

How to install macbox MCP

Install macbox MCP in Claude Code

Install macbox MCP in Cursor

Install macbox MCP in VS Code

Install macbox MCP in VS Code CLI

Install macbox MCP in Claude Desktop

Install macbox MCP in Codex

Install macbox MCP in Codex config.toml

Install macbox MCP in Gemini CLI

Install macbox MCP in Gemini settings.json

Configuration

Automated checks

README

macbox

Set up

What your agent gets

How it works

This repository

macbox MCP questions

macbox MCP server

What is macbox MCP?

About macbox MCP server

What you can do with it

How to install macbox MCP

Install macbox MCP in Claude Code

Install macbox MCP in Cursor

Install macbox MCP in VS Code

Install macbox MCP in VS Code CLI

Install macbox MCP in Claude Desktop

Install macbox MCP in Codex

Install macbox MCP in Codex config.toml

Install macbox MCP in Gemini CLI

Install macbox MCP in Gemini settings.json

Configuration

Automated checks

README

macbox

Set up

What your agent gets

How it works

This repository

macbox MCP questions