
xcodebuildmcp-cli
โ Officialโ 6,033by 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).
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 --helpIf missing, install with one of:
brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcpnpm install -g xcodebuildmcp@latestRe-check after install:
xcodebuildmcp --helpStep 2: Use Help-First Discovery
Discover workflows and arguments from the CLI itself:
xcodebuildmcp --help
xcodebuildmcp tools
xcodebuildmcp <workflow> --help
xcodebuildmcp <workflow> <tool> --helpUse 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-runcommand. - Do not chain
buildthenbuild-and-rununless 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.
npx skills add getsentry/xcodebuildmcp --skill "xcodebuildmcp-cli" --full-depthRun this in your project โ your agent picks the skill up automatically.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ