XcodeMCP

MCP server for Xcode build automation and log parsing.

What it does

• Opens Xcode projects and triggers builds in Xcode, not using xcodebuild. [^1]
• Parses build logs to extract errors and warnings using XCLogParser
• Provides MCP tools for AI assistants to interact with Xcode

[^1]: For an alternative that uses xcodebuild, see XcodeBuildMCP

Requirements

• macOS with Xcode installed
• Node.js 18+
• XCLogParser: brew install xclogparser

Usage

Quick Install

<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code"> <img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5"> <img src="https://cursor.com/deeplink/mcp-install-dark.svg" height=20 alt="Install MCP Server">

Install from npm

Run directly with npx:

brew install xclogparser
npx xcodemcp@latest

Or install globally:

brew install xclogparser
npm install -g xcodemcp

MCP Configuration

Add to your MCP configuration:

{
  "mcpServers": {
    "xcodemcp": {
      "command": "npx",
      "args": ["xcodemcp@latest"],
      "env": {}
    }
  }
}

Claude Code CLI Setup

To add XcodeMCP to Claude Code using the command line:

claude mcp add-json XcodeMCP '{
  "command": "npx",
  "args": ["xcodemcp@latest"],
  "env": {}
}'

Or clone locally:

git clone https://github.com/lapfelix/XcodeMCP.git
cd XcodeMCP
npm install
node index.js

Available Tools

• xcode_open_project - Open Xcode projects and workspaces
• xcode_build - Build and get errors/warnings
• xcode_build_scheme - Build with specific scheme and destination
• xcode_clean - Clean build artifacts
• xcode_test - Run unit and UI tests
• xcode_run - Run the active scheme
• xcode_debug - Start debugging session
• xcode_stop - Stop current build/run/test operation
• xcode_get_schemes - List all available schemes
• xcode_get_run_destinations - List simulators and devices
• xcode_set_active_scheme - Switch between schemes
• xcode_get_workspace_info - Get workspace details and status
• xcode_get_projects - List projects in workspace
• xcode_open_file - Open specific files in Xcode

Example

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "xcode_build", "arguments": {}}}' | node index.js

Output:

❌ BUILD FAILED (1 errors)
ERRORS:
  • /path/file.swift: 'SomeType' file not found