/xcodebuildmcp-cli
Official skill for the XcodeBuildMCP CLI. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).
$ npx -y skills add getsentry/xcodebuildmcp --skill xcodebuildmcp-cli --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/xcodebuildmcp-cli
Context preview
The summary Claude sees to decide when to auto-load this skill.
Official skill for the XcodeBuildMCP CLI. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).
SKILL.md
xcodebuildmcp-cli.SKILL.mdname: xcodebuildmcp-cli
description: Official skill for the XcodeBuildMCP CLI. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).
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.
Read more
name: xcodebuildmcp-cli description: Official skill for the XcodeBuildMCP CLI. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).
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.
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Repo: getsentry/xcodebuildmcp