XcodeBuild MCP
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-mcpOfficial 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
brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcpOption B — npm (Node.js 18+)
npm install -g xcodebuildmcp@latestVerify either install:
xcodebuildmcp --helpConnect 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.