XcodeBuildMCP (now MobileBuildMCP)
XcodeBuildMCP
An MCP server and CLI from Sentry for building, running and testing Xcode iOS and macOS projects from an AI agent
- 6,513 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs xcodebuild, simulators and apps on the machine
- Sends error telemetry to Sentry
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/xcodebuildmcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs xcodebuild, simulators and apps on the machine
- Sends error telemetry to Sentry
This is third-party code. Review the repository files before installing.
What it does
The project was renamed: the former XcodeBuildMCP is now called MobileBuildMCP, and the old xcodebuildmcp package stays on npm. XcodeBuildMCP gives the agent tools for Xcode projects: building for simulator and device, preparing and running tests, capturing logs and debugging. One package works in two modes: xcodebuildmcp mcp starts the MCP server, and the other commands expose the same tools directly in the terminal. A per-workspace background daemon handles stateful work such as log capture. The init command installs two optional skills that teach the agent to use the MCP server or the CLI.
Who it is for. For iOS and macOS developers who use Claude Code, Cursor or Codex.
Good fit when
- You want the agent to build the project and see compiler errors
- You need to run the app in a simulator and run tests from the agent
- You want one tool usable from both terminal and agent
Not a fit when
- You are not on macOS
- The project does not use Xcode, such as a pure Swift package on Linux
Example request
Build the app for the iPhone simulator, run the tests and fix the failing onesMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
XCODEBUILDMCP_SENTRY_DISABLED- Controls sending error telemetry to Sentry
Limitations
It works only on macOS 14.5+ with Xcode 16+; the npm install needs Node.js 18+. Device tools require code signing to be configured. The server sends internal error telemetry to Sentry, which can be disabled. xcodebuild runs with Swift macro validation skipped.
How to disable. Run claude mcp remove XcodeBuildMCP or delete the server block from the MCP config, then npm uninstall -g xcodebuildmcp or brew uninstall xcodebuildmcp.
FAQ
Did the project have a different owner?
Yes, it was originally maintained by Cameron Cooke and now belongs to Sentry.
How do I update?
With xcodebuildmcp upgrade --yes; check for a new version with upgrade --check.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server to drive iOS and Android: simulators, emulators and real devices via accessibility trees and screenshots
An MCP server that takes plain-language commands and drives the iOS Simulator through idb: apps, taps, logs
An MCP server for the iOS Simulator: taps, swipes, text input, accessibility tree, screenshots, video and app control
MCP server for Apple's official developer docs: search frameworks, APIs, code samples and WWDC sessions from your agent
An MCP server that drives an Android device over ADB: app navigation, input and automated tests
An MCP server that drives a real iPhone through macOS iPhone Mirroring: the agent sees the screen, taps, swipes and types
README in short
The README covers installation via Homebrew or npm, macOS, Xcode and Node.js requirements, and running the server via npx. It describes the two skills and installing them with init, build quirks and telemetry. It gives CLI examples for simulator builds and tests. Client setup lives on xcodebuildmcp.com. MIT licensed.