# MobileBuildMCP [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/getsentry/MobileBuildMCP  
**GitHub Stars:** 6592  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mobilebuildmcp

## Description
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mobilebuildmcp": {
    "command": "npx",
    "args": ["-y","mobilebuildmcp@latest"]
  }
}
```

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/mobilebuildmcp/readme_

