🔨 Xcode MCP Server

The first MCP server for Xcode — Let AI agents like Claude build your iOS apps!

An MCP (Model Context Protocol) server that gives AI assistants the power to work with Xcode projects. List projects, read configurations, inspect targets, and trigger builds — all through natural conversation.

✨ Features

🚀 Quick Start

Prerequisites

• macOS with Xcode Command Line Tools (xcode-select --install)

• Node.js 18+

• npm or yarn

Installation

# Clone the repo
git clone https://github.com/airdrop-alpha/xcode-mcp.git
cd xcode-mcp

# Install dependencies
npm install

# Build TypeScript
npm run build

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "xcode": {
      "command": "node",
      "args": ["/absolute/path/to/xcode-mcp/dist/index.js"]
    }
  }
}

OpenClaw

Add to your OpenClaw MCP config:

{
  "mcpServers": {
    "xcode": {
      "command": "node",
      "args": ["/absolute/path/to/xcode-mcp/dist/index.js"]
    }
  }
}

💬 Example Conversation

You: List Xcode projects in my Developer folder

Claude: Found 3 Xcode projects:
  • MyApp.xcodeproj
  • TestFramework.xcodeproj
  • SampleProject.xcodeproj

You: What targets does MyApp have?

Claude: MyApp has 3 targets:
  • MyApp (application)
  • MyAppTests (unit-test)
  • MyAppUITests (ui-test)

You: Build it for iPhone 15 simulator

Claude: ✅ Build succeeded!

🛠️ Tool Reference

list-projects

Find Xcode projects in a directory (recursive, 5 levels deep).

{ "directory": "/path/to/search" }

read-project

Parse an Xcode project file and return its structure.

{ "projectPath": "/path/to/MyApp.xcodeproj" }

Returns: Project name, targets, build configurations, source files.

list-targets

List build targets with their product types.

{ "projectPath": "/path/to/MyApp.xcodeproj" }

Returns: Target names and types (app, framework, test, etc.)

list-schemes

List available schemes (shared and user).

{ "projectPath": "/path/to/MyApp.xcodeproj" }

build

Build a project using xcodebuild.

{
  "projectPath": "/path/to/MyApp.xcodeproj",
  "scheme": "MyApp",
  "configuration": "Debug",
  "destination": "platform=iOS Simulator,name=iPhone 15",
  "clean": false
}

xcodebuild-info

Get Xcode version and SDK information. No parameters required.

🏗️ Architecture

xcode-mcp/
├── src/
│   ├── index.ts         # MCP server entry point
│   └── xcode-parser.ts  # Xcode project file parser
├── dist/                # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

⚠️ Current Limitations

• Parses .xcodeproj files directly (simplified parser)

• .xcworkspace support coming soon

• Build output truncated to last 5KB for large projects

• Code signing disabled by default for faster builds

🗺️ Roadmap

• Workspace (.xcworkspace) support

• Simulator management (list, boot, install)

• Test execution with result parsing

• Swift Package dependencies

• Provisioning profile management

• App Store Connect integration

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md first.

# Development mode (hot reload)
npm run dev

# Test with MCP Inspector
npm run inspect

📄 License

MIT © 2026

Built for the AI-assisted development era. 🤖