Release v2.0.0

Release v2.0.0

New! CLI

XcodeBuildMCP now includes a first-class CLI for direct terminal usage, scripting, and CI workflows. All the same tools available via MCP are accessible from the command line.

npm install -g xcodebuildmcp@beta
xcodebuildmcp tools # List available tools
xcodebuildmcp simulator build-and-run --scheme MyApp --project-path ./MyApp.xcodeproj

Stateful operations (log capture, debugging, video recording) are backed by a per-workspace background process that starts automatically and shuts down after idle. See docs/CLI.md for full documentation.

New! Configuration File

Project-level configuration via .xcodebuildmcp/config.yaml replaces the need for environment variables. Set your project path, scheme, simulator, enabled workflows, debug settings, and more in one place. Environment variables still work but the config file takes precedence.

schemaVersion: 1
enabledWorkflows:
  - simulator
  - ui-automation
  - debugging
sessionDefaults:
  scheme: MyApp
  projectPath: ./MyApp.xcodeproj
  simulatorName: iPhone 16

See docs/CONFIGURATION.md for the full reference.

New! Xcode IDE Integration

XcodeBuildMCP can now proxy tools from Xcode 26.3's built-in MCP bridge, giving your agent access to Xcode IDE capabilities like Preview rendering, the Issue Navigator, and documentation search. Enable the xcode-ide workflow to use this. Setup instructions for both Codex Agent and Claude Code Agent in Xcode are included. See docs/XCODE_IDE_MCPBRIDGE.md for details.

Added

• LLDB Debugging: Attach a debugger to simulator apps, set breakpoints, inspect variables, view the call stack, and run LLDB commands — all through your agent. Supports both DAP and LLDB-CLI backends. See docs/TOOLS.md for the debugging tools.
• Session default persistence: Session defaults can now be saved to the config file with persist: true, so your preferred project, scheme, and simulator are remembered across sessions.
• Log subsystem filtering: Filter simulator log capture by subsystem — choose app (default), all, swiftui (for Self._printChanges() output), or a custom list of subsystems.
• Agent skills: Optional skill files that prime your agent with usage instructions for the MCP server or CLI. Install via the provided shell script or manually. See docs/SKILLS.md.
• MCP tool annotations: All tools now include MCP-standard annotations (read-only vs. destructive, idempotent, etc.) for clients that support them.
• Simulator name resolution: Session defaults now accept a simulator name and automatically resolve it to a device ID.
• Launch environment variables: Launch tools now accept an optional env object so you can pass runtime environment variables when starting apps on simulator or device.

Changed

• Simulator tools are now the default workflow. Previously all workflows loaded by default, increasing context usage.
• Bundled AXe updated to 1.3.0.
• Landscape screenshots now orient correctly.
• Simulator platform detection and default refresh behavior are more reliable, so simulator commands stay aligned with your current defaults as they change.

Fixed

• Fixed incremental builds corrupting arguments when strings contained substrings matching build flags.
• Fixed build path handling so relative project, workspace, and derived data paths resolve correctly even when commands run from different working directories.
• Fixed working-directory leakage in incremental build setup that could affect concurrent requests.
• Fixed simulator screenshot matching for similarly named devices (for example, iPhone 15 and iPhone 15 Pro).

CLI Installation

npm install -g xcodebuildmcp@2.0.0
xcodebuildmcp --help

MCP Setup

"XcodeBuildMCP": {
  "command": "npx",
  "args": ["-y", "xcodebuildmcp@2.0.0", "mcp"]
}

📦 NPM Package: https://www.npmjs.com/package/xcodebuildmcp/v/2.0.0