Xcodebuildmcp CLI

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

bun add -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.