A robust toolset for managing Xcode builds, test execution, simulator automation, and device debugging through an AI-ready interface.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install xcodebuildmcp
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install xcodebuildmcp using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is XcodeBuildMCP?
XcodeBuildMCP is a specialized integration designed for the Openclaw Skills ecosystem that empowers AI agents to interact directly with Apple's development toolchain. It provides a standardized interface for building and running iOS or macOS applications, managing simulators, and executing complex UI automation scripts. By abstracting the complexities of xcodebuild and simctl, this skill allows for high-level command execution while maintaining technical precision.
This skill is essential for developers looking to automate repetitive tasks like scheme discovery, session configuration, and log gathering. As part of the wider range of Openclaw Skills, it enables a safe and repeatable workflow for application lifecycle management, from initial build to final verification via screenshots and media capture.
XcodeBuildMCP Use Cases
- Automating the build and run cycle for iOS apps on specific simulator versions or hardware.
- Running comprehensive test suites and automatically capturing failure logs for AI analysis.
- Performing UI automation and accessibility testing through coordinate-based gestures and UI descriptions.
- Managing simulator environments by toggling Dark Mode, setting locations, or erasing data.
- Streamlining debugging sessions by attaching LLDB or capturing real-time device logs.
How XcodeBuildMCP Works
- Discovery Phase: The agent uses discovery tools to scan the file system for projects, workspaces, and available schemes.
- Session Configuration: Key parameters such as project paths and target device IDs are set as defaults to streamline subsequent tool calls.
- Task Execution: Specific commands are triggered to compile code, launch applications, or initiate test bundles across selected targets.
- Observability: The skill captures evidence of execution through screenshots, screen recordings, or log streams.
- Debugging and Refinement: Results are analyzed, and if necessary, LLDB is utilized for deeper inspection or UI elements are re-described for further automation.
XcodeBuildMCP Setup
To utilize this skill within the Openclaw Skills framework, ensure the XcodeBuildMCP server is correctly configured in your environment.
# Step 1: Discover your local projects
mcp__xcodebuildmcp__discover_projs
# Step 2: Set your active session defaults
mcp__xcodebuildmcp__session-set-defaults --workspacePath "./App.xcworkspace" --scheme "Production"
# Step 3: Execute a build and run on a simulator
mcp__xcodebuildmcp__build_run_sim --useLatestOS true
XcodeBuildMCP Data Schema & Taxonomy
| Data Component | Description |
|---|---|
| Session Defaults | Persisted configuration for workspace path, project path, scheme, and target IDs. |
| UI Hierarchy | A structured representation of the screen layout used to identify elements before interaction. |
| Media Assets | Output directory for .png screenshots and .mp4 screen recordings generated during automation. |
| Logs | Standardized output for simulator system logs and Xcode build logs. |
XcodeBuildMCP Advanced Features
- Deep integration with LLDB for advanced debugging, including breakpoint management and process attachment.
- Comprehensive UI automation suite including tap, swipe, type, and long-press gestures based on UI element discovery.
- Multi-target support enabling simultaneous testing or management of simulators, physical devices, and macOS targets.
- Automated media capture capabilities for documenting UI states and error conditions during automated runs.
- Smart target selection logic to automatically pick the latest OS versions when specific IDs are not provided.
SKILL.md
Loading
Related Openclaw Skills
Groq Voice Transcriber
A high-performance speech-to-text skill that transcribes Telegram voice messages using the Groq Whisper API for lightning-fast AI processing.
Web to Obsidian Content Capture
A seamless utility for scraping web content, performing high-quality translations, and importing formatted Markdown files directly into an Obsidian vault.
Prompt Engineer
An advanced engineering skill for designing, optimizing, and diagnosing system prompts for autonomous agents and advisory AI using a three-layer architecture.
openclaw-notion-api
A powerful integration for programmatically managing Notion pages, data sources, and media uploads using the latest API specifications.
Free Search
A completely free web search tool for AI agents that leverages Bing results without requiring an API key or registration.
Personas
An AI-driven system for creating and deploying specialized conversational subagents with distinct identities and persistent memory.
Featured*
