xpresso

Xcode MCP server. Build, test, run, and manage simulators directly from Claude Code — no Xcode GUI needed.

Quick Start

claude mcp add xpresso -- npx xpresso-mcp

That's it. Restart Claude Code and you're ready.

Requirements

• Node.js >= 18 (or Bun)
• Xcode with command line tools (xcode-select --install)

Tools

| Tool | Description | |------|-------------| | xpresso_build | Build project/workspace with scheme | | xpresso_test | Run unit/UI tests | | xpresso_run | Build, install, and launch on simulator | | xpresso_clean | Clean build folder | | xpresso_schemes | List schemes, targets, configurations | | xpresso_build_settings | Show resolved build settings | | xpresso_simulators | List available simulators | | xpresso_boot_simulator | Boot a simulator | | xpresso_shutdown_simulator | Shutdown a simulator | | xpresso_devices | List connected physical devices | | xpresso_logs | Get output from last operation |

Examples

Build a project:

xpresso_build(scheme: "MyApp", workspace: "MyApp.xcworkspace")

Run tests:

xpresso_test(scheme: "MyApp", workspace: "MyApp.xcworkspace", destination: "platform=iOS Simulator,name=iPhone 16")

Boot simulator and run:

xpresso_boot_simulator(simulator: "iPhone 16")
xpresso_run(scheme: "MyApp", workspace: "MyApp.xcworkspace", simulator: "<UDID>")

Development

git clone https://github.com/alisheryeginbay/xpresso.git
cd xpresso
bun install
bun run src/index.ts

License

MIT