xcodebuildmcp

Complete iOS/macOS/watchOS/tvOS/visionOS build, test, debug, and UI automation through Xcode without raw command-line tools. Simulator workflows: build, run, test, install, and launch apps on iOS simulators with state management (boot, erase, location, appearance) Device and macOS workflows: build, test, install, and launch on physical devices with code signing, plus native macOS app support Debugging and inspection: LLDB attachment with breakpoints, stack traces, variable inspection, plus screenshot capture and view hierarchy inspection with tap/swipe/gesture automation Session defaults: configure project, scheme, simulator, and device once to avoid repetitive parameters across commands Project discovery and scaffolding: find Xcode projects/workspaces, list schemes, inspect build settings, and generate new iOS/macOS templates

INSTALLATION
npx skills add https://github.com/cameroncooke/xcodebuildmcp --skill xcodebuildmcp
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2a

  • Call session_show_defaults before the first build/run/test action in a session.
  • Use discover_projs only when defaults show missing or incorrect project/workspace context.
  • Do not run discovery speculatively or in parallel with session_show_defaults.
  • For simulator run intent, prefer the combined build-and-run tool instead of separate build then run calls.
  • Do not chain build-only then build-and-run unless the user explicitly requests both.

Step 2: Understand Workflow-Scoped Tool Availability

  • Not all tools are enabled by default; tool availability depends on enabled workflows.
  • If a tool is expected but missing, check enabled workflows first.
  • Update enabled workflows in .xcodebuildmcp/config.yaml, then ask user to reload/restart the session to surface refreshes.

Step 3: Report Context Clearly

  • Return the active defaults context used for execution (project/workspace, scheme, simulator/device).
  • For failures, include the exact failing step and the next actionable command/tool call.
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card