getsentry/XcodeBuildMCP
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
6,199 ★308 forksTypeScriptUpdated 1d ago
What you need to know
Sentry's MCP server and CLI for AI agents working on iOS and macOS projects: builds for simulators, prepares portable test products, and runs tests directly from agent tools or the command line.
Install
brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp npm install -g xcodebuildmcp@latest Most clients can run it on demand via npx -y xcodebuildmcp@latest mcp
Usage
- •Start the MCP server with `xcodebuildmcp mcp` after registering in Cursor/Claude Code/Codex (drop-in config snippets in docs)
- •CLI: xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj
- •Prepare portable test products: xcodebuildmcp simulator build --scheme MyApp --build-for-testing --test-products-path ./MyApp.xctestproducts, then xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts
- •Install agent skills with `xcodebuildmcp init` (or npx -y xcodebuildmcp@latest init); check updates with `xcodebuildmcp upgrade --check`
Key features
- ✓Single package with both a CLI and an MCP server
- ✓Simulator build, build-for-testing (portable test products), and test execution without running tests first
- ✓Two optional agent skills: MCP Skill and CLI Skill
- ✓Per-workspace daemon for stateful operations (log capture, debugging) that auto-starts as needed
- ✓Requests xcodebuild to skip macro validation to avoid errors when building Swift Macro projects
Best for
AI agents that need to build, test, and iterate on iOS/macOS projects against Xcode.
Caveats
- ⚠Requires macOS 14.5+, Xcode 16.x+, Node.js 18+ (Node not needed for Homebrew install)
- ⚠Device tools require code signing configured in Xcode
- ⚠Uses Sentry for internal runtime error telemetry (opt-out available via Privacy docs)
Platforms: macOSClients: Cursor · Claude Code · Codex
Documentation ↗Reviewed 2026-08-07
Topics
- Stars
- 6,199★
- Forks
- 308
- Language
- TypeScript
- License
- MIT
- Created
- 2025-03-09
- Last push
- 2026-08-05