xcodebuildmcp-cli
xcodebuildmcp-cli is a Model Context Protocol server that equips AI agents with direct control over Xcode build pipelines for iOS and macOS development. It bridges the gap between agent reasoning and native build tooling, enabling automated compilation, testing, and app deployment through a unified CLI interface. Perfect for teams integrating AI-assisted development into their Apple platform workflows.
xcodebuildmcp-cli is a Model Context Protocol server that gives AI agents direct control over Xcode build pipelines for iOS and macOS development. It bridges agent reasoning with native build tooling, enabling automated compilation, testing, and app deployment through a unified CLI interface. Use it to integrate AI-assisted development into your Apple platform workflows.
AI-generated summary based on this skill's SKILL.md
Install
getsentry/XcodeBuildMCP/xcodebuildmcp-cli · repository language: TypeScript
git clone https://github.com/getsentry/XcodeBuildMCP
cp -r XcodeBuildMCP/skills/xcodebuildmcp-cli ~/.claude/skills/xcodebuildmcp-cliFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is xcodebuildmcp-cli and how do I use it?
xcodebuildmcp-cli is a Model Context Protocol server that gives AI agents direct control over Xcode build pipelines for iOS and macOS development. It bridges agent reasoning with native build tooling, enabling automated compilation, testing, and app deployment through a unified CLI interface. Use it to integrate AI-assisted development into your Apple platform workflows.
How do I install and configure the xcodebuildmcp CLI tool?
xcodebuildmcp-cli is distributed under the MIT license. Installation involves setting up the MCP server in your environment and configuring it to communicate with your Xcode projects. Once installed, you can invoke build commands directly through the CLI to automate your iOS, macOS, watchOS, tvOS, and visionOS development workflows.
Can xcodebuildmcp automate UI testing and simulator workflows?
Yes, xcodebuildmcp-cli supports automated UI testing and simulator workflows. It provides CLI automation for managing simulators, running tests, and orchestrating complex build-test-run sequences. This enables hands-off testing across different device configurations and OS versions without manual Xcode interaction.
What debugging and logging capabilities does xcodebuildmcp offer?
xcodebuildmcp-cli includes debug and log capture features for Apple platform apps. You can extract detailed build logs, runtime diagnostics, and app output through the CLI, making it easier to troubleshoot issues and monitor app behavior during automated development cycles.
What build workflows and commands are available in xcodebuildmcp?
xcodebuildmcp-cli provides comprehensive build automation for iOS, macOS, watchOS, tvOS, and visionOS projects. Available commands include project discovery, build configuration, test execution, simulator management, and device deployment. Use the help command to explore the full command set for your specific workflow needs.
How does xcodebuildmcp compare to xcodebuild or xcrun simctl?
xcodebuildmcp-cli wraps and extends native Xcode tooling (xcodebuild, xcrun simctl) with AI-agent-friendly automation. While xcodebuild and xcrun simctl require manual orchestration, xcodebuildmcp provides a unified MCP interface that agents can reason about and execute programmatically, streamlining complex multi-step workflows.
SKILL.md
rendered from the published skill — quoted content, verbatim
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-runcommand. - Do not chain
buildthen
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/xcodebuildmcp-cli/SKILL.md