--- title: "XcodeBuildMCP: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/mcp-servers/xcodebuild/ description: "Build, test and inspect Apple-platform projects through local Xcode and simulator workflows." --- # XcodeBuildMCP: review, setup & limitations · Undominated.ai > Build, test and inspect Apple-platform projects through local Xcode and simulator workflows. [← Explore all mcp servers](/mcp-servers/) APPLICATION DEVELOPMENT / Sentry / XcodeBuildMCP maintainers # XcodeBuildMCP Build, test and inspect Apple-platform projects through local Xcode and simulator workflows. See setup guidance ↓Original source ↗ SOURCE REVIEW Reviewed 2026-09-21 Evidence 6 linked sources Publisher Sentry / XcodeBuildMCP maintainers Licence MIT ↗ Revision e6ef59b49b44 Read what was—and wasn’t—checked ↓ “A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.” Sentry / XcodeBuildMCP maintainers · upstream description ↗ Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - Provides structured build/test and simulator tools for a workflow browser automation cannot cover. - Workflow selection keeps device, debugger and UI-automation tools optional rather than enabling every capability at startup. ### A good fit for - Build and test an iOS app on a simulator. - Investigate Apple-project build results inside an MCP client. ### Weigh up before choosing - Requires macOS and Xcode; physical-device workflows need code signing. - Build/test tools execute project build steps, create artifacts and can manage simulator state. The README says macro validation is skipped. - Internal runtime error telemetry is enabled by default; XCODEBUILDMCP_SENTRY_DISABLED=true is the documented opt-out. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - Pinned README, package.json, MIT licence and server startup/registration. - Official MCP client, tool, workflow configuration and privacy documentation. ### Our findings - Only simulator workflows are enabled by default; device, debugging, macOS and UI automation need configuration. - The local server uses stdio. The privacy guide distinguishes internal runtime telemetry from user build failures and tool payloads; this was not independently observed at runtime. ### Not established by this review - Server launch, authenticated tool calls, and release-to-source parity were not tested. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Connect a server deliberately. Upstream setup instructions ↗ DOCUMENTED COMMAND codex mcp add XcodeBuildMCP -- npx -y xcodebuildmcp@latest mcp Copy command ↗ Copying does not execute this command. It may retrieve a newer version than the reviewed source. - Install Xcode and ensure the project’s build/signing setup works on the Mac. - Run the shown Codex registration command, or use the documented JSON for another client. - Select the project/scheme and enable additional workflows only when needed; apply the telemetry setting if desired. ### Before you start - macOS with a supported Xcode installation. - Node.js/npx for the shown command; appropriate project and signing access. ### Documented configuration example Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts. { "mcpServers": { "XcodeBuildMCP": { "command": "npx", "args": [ "-y", "xcodebuildmcp@latest", "mcp" ] } } } Copy configuration ↗ ### Compatibility Codex · Claude Code · Cursor · Claude Desktop · macOS ### Implementation TypeScript ### Transports stdio ### Local Xcode and project access - Reads local project/build information and runs Xcode build and test tooling. - Can create build artifacts, install/launch apps and manage simulator or enabled device workflows. ### Cost model Runs with your local Apple development tools; Apple services and the AI client have their own terms. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - XcodeBuildMCP setup and scope ↗ Checked 2026-09-21 https://raw.githubusercontent.com/getsentry/XcodeBuildMCP/e6ef59b49b44012c824f0a0de261c96142e37390/README.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review - XcodeBuildMCP client setup ↗ Checked 2026-09-21 https://xcodebuildmcp.com/docs/clients Supports: install, compatibility, review - XcodeBuildMCP telemetry and opt-out ↗ Checked 2026-09-21 https://xcodebuildmcp.com/docs/privacy Supports: limitations, access, review - XcodeBuildMCP workflow configuration ↗ Checked 2026-09-21 https://xcodebuildmcp.com/docs/configuration Supports: limitations, install - XcodeBuildMCP stdio and default workflows ↗ Checked 2026-09-21 https://raw.githubusercontent.com/getsentry/XcodeBuildMCP/e6ef59b49b44012c824f0a0de261c96142e37390/src/server/server.ts Supports: language, transports, review, access - XcodeBuildMCP MIT licence ↗ Checked 2026-09-21 https://raw.githubusercontent.com/getsentry/XcodeBuildMCP/e6ef59b49b44012c824f0a0de261c96142e37390/LICENSE Supports: license KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Angular CLI MCP ↗ Angular CLI tools for workspace discovery, framework guidance and explicitly permitted build or test operations.](/mcp-servers/angular/)[### Playwright MCP ↗ Gives an assistant persistent browser tools for inspecting page structure, interacting with controls and collecting browser evidence.](/mcp-servers/playwright/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)