read

When using Claude Code for iOS development, raw xcodebuild commands are slow. While xcodebuild does support incremental builds, it’s not optimized for speed.

XcodeBuildMCP solves this by integrating with xcodemake — a tool that makes incremental builds significantly faster!

Setup

claude mcp add -s user XcodeBuildMCP npx xcodebuildmcp@latest \
    -e INCREMENTAL_BUILDS_ENABLED=true \
    -e XCODEBUILDMCP_ENABLED_WORKFLOWS="simulator,device,project-discovery,session-management" \
    -e XCODEBUILDMCP_SENTRY_DISABLED=true

Argument	Description
-s user	Scope: save to user config (available in all projects)
-e INCREMENTAL_BUILDS_ENABLED=true	Enable fast incremental builds via experimental xcodemake
-e XCODEBUILDMCP_ENABLED_WORKFLOWS="..."	Which tool groups to expose to Claude
-e XCODEBUILDMCP_SENTRY_DISABLED=true	Disable error reporting to Sentry

There are a few workflows for this MCP and we only enable what is necessary:

• simulator — Build/run on iOS Simulator
• device — Build/run on physical devices
• project-discovery — Find Xcode projects and schemes
• session-management — Set project/scheme/simulator defaults

Restart Claude Code after adding the MCP server.

Pitfall: Set Session Defaults First

When Claude attempts to build, it will encounter errors if session defaults aren’t configured. Tell Claude what to use upfront:

“Build and run. Use scheme MyApp on iPhone 17 Pro with latest OS.”

Claude will set the session defaults and build in one go.