XcodeBuild MCP

XcodeBuild MCP

Developer
Sentry
claudecursorvscodecodexgeneric
FreeOpen Source

About This Server

An MCP server by Sentry that provides iOS/macOS build tools for AI agents. Supports Xcode project building, test running, and simulator management — letting coding agents operate the Apple development environment.

Installation

npx -y @getsentry/xcodebuild-mcp
Official README installation guide

XcodeBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.

Option A — Homebrew

bash
brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Option B — npm (Node.js 18+)

bash
npm install -g xcodebuildmcp@latest

Verify either install:

bash
xcodebuildmcp --help

Connect your MCP client

Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page MCP Clients. Most clients can also run the MCP server on demand via npx -y xcodebuildmcp@latest mcp without a global install.

Frequently Asked Questions

What can XcodeBuild MCP do?

Lets AI agents operate Xcode projects on macOS: build projects and retrieve compilation errors, run test suites and view results, manage iOS simulators (start/stop/reset), and retrieve device logs. Enables AI-assisted end-to-end Apple platform development.

Does XcodeBuild MCP require macOS?

Yes, it must run on macOS with Xcode and Command Line Tools installed. The MCP server interacts with Xcode through the xcodebuild command-line tool, so it only works in the Apple development environment.

Is XcodeBuild MCP free?

Completely free and open source (MIT license), officially maintained by Sentry. No API key needed — it runs locally with all build operations executing on your machine.