XcodeMCP

🥈Silver

XcodeMCP is an MCP server for Xcode that wraps its AppleScript interface and uses XCLogParser to return clear build results. It benefits operations teams by automating Xcode build processes, providing structured output for CI/CD pipelines, and integrating with agentic AI tools like Claude.

5560Updated 1mo ago

Intermediate30min to implementautomation

Saves ~90 min per use

Quick InstallView Source

git clone https://github.com/lapfelix/XcodeMCP.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"step":"Install XcodeMCP and ensure it’s running. Verify the MCP server is connected to your Xcode project by checking the available actions (e.g., build, test, clean).","tip":"Use `xcodebuild -list` in your terminal to confirm your project’s schemes and targets are accessible."},{"step":"Run a build or test command using the MCP interface. For example, trigger a clean build with `xcodebuild clean -project MyApp.xcodeproj -scheme Debug`.","tip":"Specify the simulator or device target if needed, e.g., `-destination 'platform=iOS Simulator,name=iPhone 15'`."},{"step":"Parse the structured output (JSON) to extract build status, warnings, errors, and logs. Use this data to automate follow-up actions, such as notifying your team or triggering CI/CD pipelines.","tip":"For CI/CD integration, pipe the JSON output to a script that parses it and updates your build dashboard (e.g., Jenkins, GitHub Actions)."},{"step":"Iterate by refining the build command or adding custom scripts to handle specific scenarios, like running tests on multiple simulators or archiving builds for distribution.","tip":"Combine XcodeMCP with other MCP tools (e.g., GitHubMCP) to create end-to-end automation workflows, such as auto-pushing builds to TestFlight after successful tests."}]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/lapfelix/XcodeMCP

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use XcodeMCP to [ACTION] for [PROJECT_NAME]. For example: 'Use XcodeMCP to run a clean build for MyApp in Xcode and return the build results in JSON format.' Include [OPTIONS] if needed, like 'with the iOS Simulator (iPhone 15)' or 'for the Debug scheme'.

Example Output

```json
{
  "project": "MyApp",
  "action": "clean build",
  "status": "success",
  "duration_seconds": 42.3,
  "warnings": 2,
  "errors": 0,
  "build_output": {
    "targets": [
      {
        "name": "MyApp",
        "status": "built",
        "warnings": [
          {
            "file": "ViewController.swift",
            "line": 42,
            "message": "Variable 'userData' was never used",
            "severity": "warning"
          }
        ]
      }
    ],
    "logs": [
      {
        "timestamp": "2024-05-20T14:30:12Z",
        "type": "info",
        "message": "Compiling MyApp..."
      },
      {
        "timestamp": "2024-05-20T14:30:45Z",
        "type": "success",
        "message": "Build succeeded"
      }
    ]
  }
}
```