Skip to content
MCP server

MobileBuildMCP

MCP server and CLI letting AI agents build, test and run iOS and macOS Xcode projects

Actively maintainedStatus and history

The repository was last updated 3 days ago and is published under MIT.

Pricing
Open source
Platforms
macOS, CLI, self-hosted
GitHub stars
6.6K
Last commit
3 days ago
Language
TypeScript
License
MIT

Similar MCP servers

About MobileBuildMCP

MobileBuildMCP is an open-source MCP server for developer tools. It is available on macOS, CLI and self-hosted.

The README describes MobileBuildMCP as a Model Context Protocol server and command-line tool for working on Apple platform projects. It ships as one package, so the same tools can be driven by an AI coding agent over MCP or run directly from a terminal.

From the CLI, commands cover building for a simulator, preparing portable test products without running them, and running those prepared tests later on a chosen simulator. A per-workspace background daemon handles stateful operations such as log capture and debugging, starting automatically when needed.

The project targets developers who use AI coding assistants such as Cursor or Claude Code on macOS with Xcode installed. Device tools need code signing configured in Xcode, and the project notes it asks xcodebuild to skip Swift macro validation so macro-based projects build.

What it does

Simulator build and test
Builds Xcode projects for the iOS simulator and runs prepared test products from the command line.
MCP server mode
Runs as an MCP server so compatible AI coding clients can call its build and test tools.
Terminal CLI
Exposes the same tools through a mobilebuildmcp command for direct use outside an agent.
Optional agent skills
Offers MCP and CLI skills that prime an agent with instructions on using the tools.
Stateful workspace daemon
Uses a per-workspace daemon for operations such as log capture and debugging, started on demand.
In-place upgrades
Checks for newer versions and upgrades the installed CLI with a built-in command.

Good for

  • Letting an AI coding agent build an iOS app and report compile errors
  • Running Xcode test suites on a simulator from a script or CI-style terminal workflow
  • Preparing test products once and rerunning them on different simulators
  • Giving Cursor or Claude Code access to Xcode build tooling on macOS

Pricing

Open source

Free and MIT licensed; no paid plan mentioned.

MobileBuildMCP FAQ

What do I need to run it?

The README lists macOS 14.5 or later, Xcode 16.x or later, and Node.js 18.x or later unless installed via Homebrew.

How can it be installed?

Through Homebrew with a tap and brew install, or globally with npm. It can also run on demand with npx.

Do device tools work out of the box?

No. The README says device tools require code signing to be configured in Xcode.

Does it collect telemetry?

The README says it uses Sentry for internal runtime error telemetry only, with opt-out instructions in the privacy docs.

Is MobileBuildMCP free?

Yes. MobileBuildMCP is open source, so you can use and self-host it for free.

What are the best alternatives to MobileBuildMCP?

The closest alternatives to MobileBuildMCP are macbox, Codemagic MCP by usefulapi, adb-mcp: Android emulator and device control over adb, Mac YOLO Safeguards — Runaway Reaper & Token Budget MCP and Edit MCP.

Where this comes from

  • Description: written from the project's README.

How AIPoweredBot checks servers