---
name: xcodebuildmcp
description: Official skill for XcodeBuildMCP. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).
---

# xcodebuildmcp

Official skill for XcodeBuildMCP. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).

# xcodebuildmcpby sentry
Official skill for XcodeBuildMCP. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).

`npx skills add https://github.com/getsentry/xcodebuildmcp --skill xcodebuildmcp`Download ZIPGitHub

## XcodeBuildMCP

Use XcodeBuildMCP tools instead of raw `xcodebuild`, `xcrun`, or `simctl`.

Capabilities:

* Session defaults: Configure project, scheme, simulator, and device defaults to avoid repetitive parameters

* Project discovery: Find Xcode projects/workspaces, list schemes, inspect build settings

* Simulator workflows: Build, run, test, install, and launch apps on iOS simulators; manage simulator state (boot, erase, location, appearance)

* Device workflows: Build, test, install, and launch apps on physical devices with code signing

* macOS workflows: Build, run, and test macOS applications

* Log capture: Stream and capture logs from simulators and devices

* LLDB debugging: Attach debugger, set breakpoints, inspect stack traces and variables, execute LLDB commands

* UI automation: Capture screenshots, inspect view hierarchy with coordinates, perform taps/swipes/gestures, type text, press hardware buttons

* SwiftPM: Build, run, test, and manage Swift Package Manager projects

* Project scaffolding: Generate new iOS/macOS project templates

Only simulator workflow tools are enabled by default. If capabilities like device, macOS, debugging, or UI automation are not available, the user must configure XcodeBuildMCP to enable them. See https://xcodebuildmcp.com/docs/configuration for workflow configuration.

## Step 1: Establish Session Context

* Call `session_show_defaults` before the first build/run/test action in a session.

* Use `discover_projs` only when defaults show missing or incorrect project/workspace context.

* Do not run discovery speculatively or in parallel with `session_show_defaults`.

* For simulator run intent, prefer the combined build-and-run tool instead of separate build then run calls.

* Do not chain build-only then build-and-run unless the user explicitly requests both.

## Step 2: Understand Workflow-Scoped Tool Availability

* Not all tools are enabled by default; tool availability depends on enabled workflows.

* If a tool is expected but missing, check enabled workflows first.

* Update enabled workflows in `.xcodebuildmcp/config.yaml`, then ask user to reload/restart the session to surface refreshes.

## Step 3: Report Context Clearly

* Return the active defaults context used for execution (project/workspace, scheme, simulator/device).

* For failures, include the exact failing step and the next actionable command/tool call.

## More skills from sentry
sentry-cocoa-sdkby sentryFull Sentry SDK setup for Apple platforms (iOS, macOS, tvOS, watchOS, visionOS). Use when asked to "add Sentry to iOS", "add Sentry to Swift", "install…sentry-create-alertby sentryCreate Sentry alerts using the workflow engine API. Use when asked to create alerts, set up notifications, configure issue priority alerts, or build workflow…sentry-dotnet-sdkby sentryFull Sentry SDK setup for .NET. Use when asked to "add Sentry to .NET", "install Sentry for C#", or configure error monitoring, tracing, profiling, logging, or…sentry-fix-issuesby sentryFind and fix issues from Sentry using MCP. Use when asked to fix Sentry errors, debug production issues, investigate exceptions, or resolve bugs reported in…sentry-go-sdkby sentryFull Sentry SDK setup for Go. Use when asked to "add Sentry to Go", "install sentry-go", "setup Sentry in Go", or configure error monitoring, tracing, logging,…sentry-ios-swift-setupby sentrySetup Sentry in iOS/Swift apps. Use when asked to add Sentry to iOS, install sentry-cocoa SDK, or configure error monitoring for iOS applications using Swift…sentry-nextjs-sdkby sentryFull Sentry SDK setup for Next.js. Use when asked to "add Sentry to Next.js", "install @sentry/nextjs", or configure error monitoring, tracing, session replay,…sentry-otel-exporter-setupby sentryConfigure the OpenTelemetry Collector with Sentry Exporter for multi-project routing and automatic project creation. Use when setting up OTel with Sentry,…

---

**Source**: https://github.com/getsentry/xcodebuildmcp/tree/HEAD/skills/xcodebuildmcp
**Author**: sentry
**Discovered via**: mcpservers.org