🔨 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

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

MIT © 2026

---

Built for the AI-assisted development era. 🤖