iOS Simulator MCP (IDB)

Overview

An MCP server from Whitesmith that gives AI assistants tools to control the iOS Simulator, written in Python. It uses Apple's simctl for simulator management and Facebook's IDB for UI interaction. A typical use is letting Claude Code check a feature visually after implementing it.

Features

• Lists and manages simulators
• Takes screenshots and inspects the UI hierarchy
• Taps, long presses, swipes, types text and presses hardware buttons
• Triggers a shake gesture
• Launches apps by bundle ID and sets the GPS location

Requirements

• macOS with Xcode Command Line Tools
• Facebook IDB (idb-companion and the fb-idb Python package, using Python 3.11 or 3.12)
• uv and pipx

Install

1. Install the prerequisites

   xcode-select --install
   brew tap facebook/fb
   brew install idb-companion uv pipx
   pipx ensurepath
   pipx install fb-idb --python python3.11

2. Clone, install and add to Claude Code, then restart Claude Code

   git clone https://github.com/whitesmith/ios-simulator-mcp.git ~/ios-simulator-mcp
   cd ~/ios-simulator-mcp
   uv sync
   claude mcp add ios-simulator \
     -- uv run --directory ~/ios-simulator-mcp ios-simulator-mcp

Example

After implementing a screen, ask Claude Code to take a screenshot in the simulator and check the layout looks right.