Labsco
getsentry logo

xcodebuildmcp-cli

โœ“ Officialโ˜… 6,033

by sentry ยท part of getsentry/xcodebuildmcp

Official skill for the XcodeBuildMCP CLI. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeQuick setup
๐Ÿงฐ Not standalone. This skill ships with getsentry/xcodebuildmcp and only works together with that tool โ€” install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates โ€” you don't need to read it to use the skill, but it's here to audit before installing.

XcodeBuildMCP CLI

Use XcodeBuildMCP tools via the xcodebuildmcp executable instead of raw xcodebuild, xcrun, or simctl.

Step 1: Ensure the CLI Exists

Check availability:

xcodebuildmcp --help

If missing, install with one of:

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp
npm install -g xcodebuildmcp@latest

Re-check after install:

xcodebuildmcp --help

Step 2: Use Help-First Discovery

Discover workflows and arguments from the CLI itself:

xcodebuildmcp --help
xcodebuildmcp tools
xcodebuildmcp <workflow> --help
xcodebuildmcp <workflow> <tool> --help

Use this discovery path instead of memorizing static tool lists.

Step 3: Keep Execution Minimal

  • Choose the smallest command sequence that satisfies the request.
  • Prefer direct workflow commands over manual multi-step chains unless explicitly requested.
  • For simulator run intent, prefer the combined build-and-run command.
  • Do not chain build then build-and-run unless explicitly requested.

Capability Overview

xcodebuildmcp supports:

  • simulator and device build/test/run
  • debugging and log capture
  • UI automation
  • project discovery and scaffolding
  • session defaults and workflow configuration

Exit Criteria

  • CLI presence is verified or installation steps are provided.
  • Commands are discovered via --help / tools.
  • Session defaults are checked before first build/run/test action.