@ebowwa/mcp-xcode

Xcode MCP server - build, test, run, and manage simulators from Claude Code.

Installation

npm install @ebowwa/mcp-xcode

Requirements

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

Tools

Build Tools

| Tool | Description | |------|-------------| | xcode_build | Build an Xcode project/workspace | | xcode_test | Run unit/UI tests | | xcode_archive | Create .xcarchive for distribution | | xcode_clean | Clean build folder | | xcode_show_build_settings | Show all build settings for a scheme |

Project Info

| Tool | Description | |------|-------------| | xcode_project_info | Get project/workspace info | | xcode_scheme_list | List all schemes | | xcode_destination_list | List available destinations |

Simulator Tools

| Tool | Description | |------|-------------| | xcode_simulator_list | List all available simulators | | xcode_simulator_boot | Boot a simulator | | xcode_simulator_shutdown | Shutdown simulator(s) | | xcode_simulator_install | Install app on simulator | | xcode_simulator_launch | Launch app on simulator | | xcode_simulator_terminate | Terminate app on simulator | | xcode_simulator_open_url | Open URL on simulator | | xcode_simulator_take_screenshot | Take screenshot |

Device Tools

| Tool | Description | |------|-------------| | xcode_device_list | List connected physical devices | | xcode_runtime_list | List installed iOS/tvOS/watchOS runtimes |

Usage Examples

Build a Scheme

{
  "scheme": "MyApp",
  "destination": "platform=iOS Simulator,name=iPhone 15"
}

Run Tests

{
  "scheme": "MyAppTests",
  "onlyTesting": "MyAppTests/MyTestCase/testExample"
}

Boot Simulator

{
  "name": "iPhone 15",
  "runtime": "iOS 17.2"
}

Install and Launch App

{
  "appPath": "/path/to/MyApp.app",
  "bundleId": "com.mycompany.myapp"
}

Claude Code Configuration

Add to your ~/.claude.json:

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

License

MIT