xcodebuildmcp

Automate Apple platform build, test, run, debug, and UI workflows for Xcode projects.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/obadasemary/Woko --skill xcodebuildmcp-obadasemary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xcodebuildmcp
Source: https://github.com/obadasemary/Woko/tree/main/.claude/skills/xcodebuildmcp
Command: npx skills add https://github.com/obadasemary/Woko --skill xcodebuildmcp-obadasemary

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of driving Apple platform development tasks manually by centralizing build, test, run, debug, and UI automation workflows.

Core Features & Use Cases

  • Project Discovery and Configuration: Find Xcode projects and schemes, inspect build settings, and prepare the correct session defaults before running tasks.
  • Simulator and Device Workflows: Build for simulators or devices, boot simulators, install apps, launch apps, capture logs, and automate UI interactions.
  • Testing and Debugging: Run unit and UI tests, attach debuggers, inspect variables and stack traces, and capture screenshots or videos during diagnosis.
  • Use Case: A developer can quickly validate an iOS app change by discovering the project, selecting the right scheme, running simulator tests, and collecting logs from a failing UI flow.

Quick Start

Use this Skill to discover the Xcode project, select the appropriate scheme, and run the needed build or test workflow for the Apple platform target you are working on.

Frequently Asked Questions about xcodebuildmcp

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

FAQPage Schema
How do I automate iOS simulator testing and UI automation workflows for Xcode projects?

Automate iOS simulator testing and UI automation by discovering your Xcode project, selecting the appropriate scheme, and running the needed build or test workflow. This centralizes simulator management, app installation, and UI interactions into one automated process.

What's the best way to run unit and UI tests for an Apple platform app?

The best way to run unit and UI tests for an Apple platform app is using an automated workflow that boots simulators, installs the app, executes the tests, and captures logs or screenshots from failing UI flows for diagnosis.

Can I build and test macOS, watchOS, tvOS, and visionOS apps using Xcode workflows?

Yes, you can build and test macOS, watchOS, tvOS, and visionOS apps. The workflow supports all Apple platform development scenarios including simulator management, device testing, and SwiftPM integration.

How do I capture logs and debug a failing iOS app UI flow?

Capture logs and debug a failing iOS app UI flow by attaching debuggers, inspecting variables and stack traces, and capturing screenshots or videos. This workflow automates log collection during UI interactions to pinpoint failures.

Do I need to manually configure Xcode build settings before running automated tests?

No, you do not need to manually configure Xcode build settings. The workflow automates project discovery, inspects build settings, and prepares the correct session defaults before running tests.

Why does my Xcode build fail when switching between simulator and device targets?

Xcode builds can fail when switching targets due to misconfigured session defaults. An automated workflow discovers the correct project schemes and applies the appropriate simulator or device configurations to prevent build errors.