1,900 stars
77 forks
v1.10.4

AI-Powered Xcode Automation

Let AI assistants build, test, and debug your iOS apps autonomously. XcodeBuildMCP bridges the gap between AI agents and Xcode, enabling intelligent development workflows that fix build errors, manage simulators, and deploy to devices—all through natural language commands.

XcodeBuildMCP Banner
View on GitHub
MIT Licensed
Open Source
Active Development

Powerful Xcode Integration

Everything you need to integrate Xcode workflows with AI assistants and automation tools.

Autonomous Development
AI agents can independently build projects, fix compilation errors, and iterate on solutions without human intervention.
Complete Workflow
From project creation to device deployment—manage the entire iOS development lifecycle through AI commands.
Lightning Fast Builds
Experimental incremental build support delivers blazing fast compilation times for rapid iteration cycles.
UI Automation
Interact with simulator UI elements, capture screenshots, and automate user interface testing workflows.
Real Device Testing
Deploy and test on physical devices over USB or Wi-Fi with comprehensive log capture and debugging support.
Multi-Client Support
Works with Cursor, Claude Desktop, VS Code, and any MCP-compatible client for maximum flexibility.

Getting Started

No installation required - just configure your MCP client

Configuration Example
Add to your MCP client configuration
{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": ["-y", "xcodebuildmcp@latest"]
    }
  }
}
Global NPM Installation
npm install -g xcodebuildmcp
{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "node",
      "args": ["xcodebuildmcp"]
    }
  }
}
Development Setup
git clone https://github.com/
cameroncooke/XcodeBuildMCP
cd XcodeBuildMCP && npm install
{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "node",
      "args": ["path/to/xcodebuildmcp/build/index.js"]
    }
  }
}

Usage Examples

See XcodeBuildMCP in action

AI Assistant Integration
Natural language commands through your AI assistant

You:

"Build my iOS project and run the tests"

AI Assistant:

I'll build your project and run the tests using XcodeBuildMCP...

✓ Build succeeded
✓ All tests passed (23/23)
Complete App Creation
From idea to running app in minutes

You:

"Create a simple iOS todo app with SwiftUI"

AI Assistant:

I'll create a complete iOS todo app for you...

✓ Scaffolded new iOS project
✓ Generated SwiftUI todo interface
✓ Built project successfully
✓ Launched in iOS Simulator
✓ Captured screenshot
✓ Tested add/delete functionality

Result:

Your todo app is running! I've tested the core features and everything works perfectly.

Help Improve XcodeBuildMCP

Contribute to make this tool even better

Contribute Code

Submit pull requests, fix bugs, or add new features

View Issues

Contributing Guide

Learn how to set up your development environment and contribute

Read Guide