mcp-xcode

Automate iOS project build, test, and diagnostics workflows with Xcode.

Updated Jan 6, 2026
One-click install
npx skills add https://github.com/nguyennamkkb/ios-spec-driven --skill mcp-xcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-xcode
Source: https://github.com/nguyennamkkb/ios-spec-driven/tree/main/src/ios_spec_driven_installer/templates/.claude/skills/mcp-xcode
Command: npx skills add https://github.com/nguyennamkkb/ios-spec-driven --skill mcp-xcode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the build, test, and diagnostics workflow for iOS projects using Xcode. It reduces manual steps and ensures repeatable, reliable results across teams.

Core Features & Use Cases

  • List schemes in a project and select a default scheme for builds.
  • Build projects or workspaces and capture build logs, time, and outcomes.
  • Run unit/UI tests, collect results, and report failures with actionable details.
  • Clean builds, fetch build settings, and perform archiving/export when preparing releases.
  • Use Case: Imagine a feature branch that needs a quick end-to-end validation: list schemes, build, test, archive, and review logs in one pass.

Quick Start

Install and enable the Xcode MCP integration. Then run a typical flow: xcode_list_schemes xcode_build --scheme <name> --configuration Debug xcode_test --scheme <name> xcode_archive --scheme <name> --export

Frequently Asked Questions about mcp-xcode

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

FAQPage Schema
How do I automate iOS build and test workflows for Xcode projects?

You can automate iOS build and test workflows by driving deterministic Xcode steps through MCP and Bash tooling, covering scheme listing, building, testing, and archiving to ensure repeatable pipelines.

Can I retrieve build logs and test failure details from an Xcode command line build?

Yes, retrieving build logs and test failure details is supported during the Xcode build and test workflow, capturing build time, outcomes, and actionable failure reports for diagnostics.

What is the best way to list and select schemes before running an Xcode build?

Listing and selecting schemes uses the Xcode automation flow to identify available project schemes and designate a default scheme before initiating subsequent build, test, or archive steps.

Does this Xcode automation approach support archiving and exporting iOS apps for release?

Yes, the Xcode automation workflow supports archiving and exporting iOS applications, allowing you to clean builds, fetch settings, and prepare release candidates within a repeatable pipeline.

How do I run unit and UI tests for an Xcode project automatically?

Running unit and UI tests automatically is handled by the Xcode workflow tooling, which executes the tests, collects results, and reports failures with actionable diagnostic details.