---
id: getsentry/XcodeBuildMCP/xcodebuildmcp-cli
version: "df169d77"
license: MIT
install: manual
updated: 2026-07-23
---

# 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.

Publisher: getsentry · Stars: 6155 · Updated: 2026-07-23

Install (manual): `git clone https://github.com/getsentry/XcodeBuildMCP`

## SKILL.md

# XcodeBuildMCP CLI

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

## Step 1: Ensure the CLI Exists

Check availability:
```bash
xcodebuildmcp --help
```

If missing, install with one of:
```bash
brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp
```

```bash
npm install -g xcodebuildmcp@latest
```

Re-check after install:
```bash
xcodebuildmcp --help
```

## Step 2: Use Help-First Discovery

Discover workflows and arguments from the CLI itself:
```bash
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.


[View on SkillFed](https://skillfed.io/getsentry/XcodeBuildMCP/xcodebuildmcp-cli) · [View on GitHub](https://github.com/getsentry/XcodeBuildMCP)