This project provides an MCP server for Xcode, enabling AI agents to programmatically manage Xcode projects, build targets, and simulator interactions. It targets AI developers and researchers seeking to automate Xcode workflows, offering a standardized interface for agent-driven development and debugging.

How It Works

The server exposes Xcode operations as tools callable via the Model Context Protocol (MCP). It leverages xcodebuild for project management and build operations, and idb_companion for simulator UI automation. This approach standardizes agent interaction, removing reliance on manual command-line calls and enabling autonomous code validation and iteration by AI agents.

Quick Start & Requirements

• Install: mise x npm:xcodebuildmcp@<version> -- xcodebuildmcp
• Prerequisites: macOS 14.5+, Xcode 18.x+, mise (package manager). For UI Automation (beta): idb-companion.
• Setup: Minimal, primarily involves configuring an MCP client.
• Docs: mise

Highlighted Details

• Supports macOS, iOS simulator, and iOS device builds.
• Enables simulator control: list, boot, install, launch apps, capture logs.
• Beta UI Automation features include tapping, swiping, and screenshots.
• Extracts bundle IDs and launches applications.

Maintenance & Community

• MIT License.
• Contribution guide available.

Licensing & Compatibility

• MIT License. Permissive for commercial use and closed-source linking.

Limitations & Caveats

UI Automation features are in beta and may have rough edges. Displaying images in tool responses is client-dependent. Macro validation is skipped by default to avoid build errors.