getsentry/XcodeBuildMCP

View on GitHub ↗

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6,256 ★314 forksTypeScriptUpdated 1mo 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
Stars
6,256★
Forks
314
Language
TypeScript
License
MIT
Created
2025-03-09
Last push
2026-08-12