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

mcpmcp-servermodel-context-protocolmodel-context-protocol-serverstag-productionxcodexcodebuild
View on GitHub ↗
Stars
6,199★
Forks
308
Language
TypeScript
License
MIT
Created
2025-03-09
Last push
2026-08-05