xcodebuildmcp

Automates building, testing, debugging, and UI automation for Apple platform apps via XcodeBuildMCP tools.

70|4|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/AlexW00/Zettel --skill xcodebuildmcp-alexw00
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: xcodebuildmcp
Source: https://github.com/AlexW00/Zettel/tree/main/.agents/skills/xcodebuildmcp
Command: npx skills add https://github.com/AlexW00/Zettel --skill xcodebuildmcp-alexw00

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with Apple platform development through raw command-line tools like xcodebuild, xcrun, and simctl is verbose and error-prone. This Skill provides a structured interface to XcodeBuildMCP tools for building, testing, running, debugging, and automating iOS, macOS, watchOS, tvOS, and visionOS apps. ## Core Features & Use Cases - Build and Run: Build and launch apps on simulators, physical devices, or macOS with tools like build_run_sim and build_run_macos. - Testing and Debugging: Run tests on simulators or devices, capture logs, and attach LLDB for breakpoints, backtraces, and variable inspection. - UI Automation: Interact with simulator UIs through taps, swipes, gestures, screenshots, and view hierarchy snapshots. - Use Case: You are developing an iOS app and want to verify a fix. Ask the AI to build and run the app on a simulator, capture a screenshot, and inspect the view hierarchy to confirm the UI renders correctly. ## Quick Start Build and run my iOS app on a simulator using XcodeBuildMCP, then take a screenshot of the result.

Frequently Asked Questions about xcodebuildmcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and run an iOS app on a simulator?β–Ό

Use the build_run_sim tool after setting session defaults with session_show_defaults and session_set_defaults. You may need discover_projs and list_schemes first to obtain valid project and scheme values.

How do I debug an iOS app with breakpoints using XcodeBuildMCP?β–Ό

Attach LLDB to the simulator app with debug_attach_sim, then use debug_breakpoint_add, debug_stack, and debug_variables to inspect execution. Use debug_continue to resume and debug_detach to end the session.

Does XcodeBuildMCP support physical devices and macOS apps?β–Ό

Yes, it provides device tools like list_devices, build_device, test_device, and install_app_device, plus macOS tools such as build_macos, build_run_macos, and test_macos for native Mac targets.

Why can't I find certain XcodeBuildMCP tools in my tool list?β–Ό

Not all workflows are enabled by default; only simulator tools are enabled initially. Use your tool-search or load-tools mechanism, check manage_workflows, or ask the user to enable additional workflows in the MCP client configuration.

How do I automate UI interactions in an iOS simulator?β–Ό

Use snapshot_ui to get element ids and coordinates, then interact with tap, swipe, type_text, gesture, or long_press. Capture results with screenshot or record_sim_video for verification.