xcodebuildmcp

Automates AWS and other cloud platform project workflows for developers and DevOps teams.

6.2k|312|Updated Mar 9, 2025
One-click install
npx skills add https://github.com/getsentry/XcodeBuildMCP --skill xcodebuildmcp-getsentry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xcodebuildmcp
Source: https://github.com/getsentry/XcodeBuildMCP/tree/main/skills/xcodebuildmcp
Command: npx skills add https://github.com/getsentry/XcodeBuildMCP --skill xcodebuildmcp-getsentry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

XcodeBuildMCP consolidates CLI and MCP server workflows, providing a unified interface to configure and execute Xcode tasks for iOS, macOS, watchOS, tvOS, and visionOS projects, reducing manual setup and context switching.

Core Features & Use Cases

  • 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

Quick Start

Install XcodeBuildMCP and run the initial setup to start using the CLI and MCP server.

Frequently Asked Questions about xcodebuildmcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Xcode builds and tests for iOS simulators?

Automate Xcode builds and tests by using a unified interface to configure sessions, discover projects, and run build or test workflows on iOS simulators. It reduces manual setup by applying session defaults for schemes and simulators.

Can I debug iOS apps and inspect view hierarchies without opening Xcode?

Debug iOS apps without opening Xcode by attaching LLDB to set breakpoints and inspect stack traces. Inspect view hierarchies with coordinates, capture screenshots, and perform taps, swipes, and text input for UI automation.

Does this work with physical iOS devices and macOS applications?

It works with physical iOS devices for building, testing, and launching apps with code signing. It also supports macOS workflows to build, run, and test macOS applications, alongside watchOS, tvOS, and visionOS projects.

How do I manage Swift Package Manager projects from the command line?

Manage Swift Package Manager projects by building, running, and testing packages directly. It consolidates CLI workflows to handle SwiftPM tasks, reducing context switching between terminal commands and IDE environments.

Do I need to configure Xcode project defaults manually for each build?

Configure Xcode project defaults once to avoid repetitive parameters for schemes, simulators, and devices. Session defaults are saved and applied automatically, with enabled workflows controlled via the config.yaml file.

What is the best way to capture logs from an iOS simulator during automated testing?

Capture logs from an iOS simulator by streaming and saving console output directly during automated testing workflows. The tool manages simulator state and captures logs to help identify issues across build and run cycles.