MobileBuildMCP logo

MobileBuildMCP

Builds and tests iOS and macOS projects through MCP or a unified CLI on macOS.

Install MobileBuildMCP

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": {
    "mobilebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "mobilebuildmcp@latest"
      ]
    }
  }
}

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

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

MobileBuildMCP gives AI coding agents and terminal users access to workflows for building and testing iOS and macOS projects. It runs as an MCP server through the `mcp` subcommand or exposes the same functionality through a unified CLI, including simulator builds, test execution, and stateful log or debugging operations. Use it when an agent needs to work with Xcode projects, simulator targets, or configured devices from macOS. The package requires macOS 14.5 or later and Xcode 16 or later.

Use cases

  • Build an Xcode project for an iOS simulator
  • Prepare and run simulator test products
  • Inspect logs while debugging a workspace
  • Connect an AI coding agent to macOS build workflows

Key features

  • MCP server for iOS and macOS development tasks
  • Unified CLI with simulator build and test commands
  • Portable test-product preparation
  • Workspace daemon for logs and debugging
  • Optional MCP and CLI agent skills
  • Homebrew and npm installation

Security & health

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

ActiveLast checked

Recent health check succeeded.

Adoption & maintenance

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

GitHub stars6.6kStargazers on the source repository.
Last commitTodayMost recent push to the default branch.

How MobileBuildMCP works

What MobileBuildMCP does

MobileBuildMCP connects MCP-compatible coding agents and command-line workflows to iOS and macOS development tasks. It provides access to project builds, simulator operations, test execution, device-related tools, log capture, and debugging workflows. The package is distributed as both an MCP server and a CLI, so the same installation can support an agent-driven workflow or direct terminal commands.

The server is intended for projects built with Apple’s Xcode toolchain. It uses xcodebuild for builds and skips macro validation requests to avoid errors in projects that use Swift Macros. Device operations depend on code signing configured through Xcode.

How it works

Run mobilebuildmcp mcp to start the MCP server for an MCP client. Clients can also launch the package on demand with npx -y mobilebuildmcp@latest mcp, avoiding a global package installation. The CLI exposes commands outside the mcp subcommand, including tool discovery with mobilebuildmcp tools, simulator builds, simulator test runs, and in-place package upgrades.

Simulator tests can be split into preparation and execution. A build can produce portable test products with --build-for-testing and --test-products-path; a later simulator test command can run those products on a selected simulator. Stateful CLI operations such as log capture and debugging use a per-workspace daemon that starts when needed.

Setup and configuration

Install with Homebrew or npm:

  • Homebrew: brew tap getsentry/xcodebuildmcp followed by brew install mobilebuildmcp
  • npm: npm install -g mobilebuildmcp@latest

Check the installation with mobilebuildmcp --help. MCP client configuration examples are available for Cursor, Claude Code, and Codex. The package requires macOS 14.5 or later and Xcode 16.x or later. Node.js 18.x or later is needed for npm installation and operation; Homebrew installation does not require a separate Node.js installation.

Two optional agent skills are available. The MCP Skill supplies guidance for using the server’s tools, while the CLI Skill helps agents navigate the command-line interface. Install them with mobilebuildmcp init or npx -y mobilebuildmcp@latest init.

Tools and capabilities

  • Start an MCP endpoint for compatible coding clients.
  • List available tools from the command line.
  • Build iOS and macOS projects for simulators.
  • Prepare test products and run them later on a selected simulator.
  • Work with device-oriented operations when Xcode code signing is configured.
  • Support log capture and debugging through a workspace daemon.
  • Check for updates and upgrade the installation from the CLI.

Limitations and notes

The package targets macOS and depends on Apple’s Xcode environment, so it is not a general cross-platform build service. Device tools require valid code-signing configuration in Xcode. Internal runtime error telemetry is sent to Sentry, with opt-out instructions available through the project’s privacy documentation.

Reviews

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

Frequently Asked Questions about MobileBuildMCP

MobileBuildMCP is an MCP server that connects AI coding agents to iOS and macOS projects through Xcode workflows. Its main tools cover project builds, simulator testing, device operations, log capture, and debugging, while its companion CLI exposes these capabilities for direct terminal use on macOS.

Install it with Homebrew or npm, then start it with `mobilebuildmcp mcp`. Homebrew uses `brew tap getsentry/xcodebuildmcp` and `brew install mobilebuildmcp`; npm uses `npm install -g mobilebuildmcp@latest`. Clients can also run it on demand with `npx -y mobilebuildmcp@latest mcp`.

Yes, MobileBuildMCP provides configuration guidance for Cursor. Start the MCP server through the client configuration or use the package’s on-demand `npx -y mobilebuildmcp@latest mcp` command where supported.

MobileBuildMCP requires macOS 14.5 or later and Xcode 16.x or later. Node.js 18.x or later is required for npm-based installation; Homebrew installation does not require Node.js separately. Device operations also require code signing configured in Xcode.

Related MCP servers

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 PreviewMobileBuildMCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mobilebuildmcp?style=directory)](https://allmcps.com/mcp/mobilebuildmcp)
HTML Embed
<a href="https://allmcps.com/mcp/mobilebuildmcp"><img src="https://allmcps.com/api/badge/mobilebuildmcp?style=directory" alt="MobileBuildMCP on AllMCPs" /></a>