@ebowwa/mcp-xcode

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

Installation

npm install @ebowwa/mcp-xcode

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

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

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

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

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

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

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

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

Add to your ~/.claude.json:

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

MIT