🔨 Xcode MCP Server

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

License: MIT MCP Platform

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

Tool	Description
`list-projects`	Find all Xcode projects in a directory tree
`read-project`	Parse .xcodeproj structure (targets, configs, files)
`list-targets`	Get build targets with product types
`list-schemes`	List available build schemes
`build`	Trigger xcodebuild with configurable options
`xcodebuild-info`	Get Xcode version and available SDKs

🚀 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

Built for the AI-assisted development era. 🤖

Xcode MCP Server