io.github.EthanAckerman-git/preflight-ios-mcp

Get the accessibility element tree of the current Simulator screen. Shows roles, labels, values, and positions of UI elements.

Add photos or videos to the simulator's camera roll from local file paths.

Get detailed metadata about an installed app (bundle ID, paths, version, etc.).

Set Face ID / Touch ID enrollment state. Test biometric authentication flows.

Boot an iOS Simulator device. Opens the Simulator app. Use simulator_list_devices to find device names/UDIDs.

Read UserDefaults values from inside the simulator. Inspect app preferences, feature flags, and configuration.

Write UserDefaults values inside the simulator. Set feature flags, change app configuration, or inject test data.

Returns the accessibility element at given coordinates on the iOS Simulator screen. Shows element type, label, value, and frame.

Generate a diagnostic summary: booted devices, Xcode version, disk usage, and system info.

Quick check: does an element matching your criteria exist on screen right now? Returns true/false. Useful for conditional logic.

Factory reset a simulator device. Erases all content and settings.

Get the filesystem path to an app's container (bundle, data, or shared groups). Use this to find where the app stores its files.

Get the UDID of the currently booted iOS Simulator.

Read the text content of the simulator clipboard.

Retrieve crash reports from ~/Library/Logs/DiagnosticReports/. Shows stack traces, exception info, and thread states. Filter by process name.

Read an environment variable from the running simulator device (e.g., HOME, TMPDIR, PATH).

Get recent device/app logs. Filter by process name, subsystem, log level, time range, and message content. Essential for debugging app behavior.

Get diagnostic info about the Simulator window geometry and coordinate mapping. Useful for debugging tap/swipe accuracy.

Grant, revoke, or reset app permissions (camera, location, photos, contacts, microphone, etc.).

Trigger iCloud sync on the device. Requires the device to be signed into an Apple ID.

Install a .app bundle onto the simulator from a local file path.

Install an .xcappdata package to replace the current app container contents. Useful for restoring test data snapshots.

Manipulate the device keychain: add root certificates, add certificates, or reset the entire keychain.

Launch an app by bundle ID. Optionally pass launch arguments and environment variables.

List files in an app's data container. Shows Documents, Library, Preferences, Caches, tmp, etc. Use to find databases, plists, caches.

List all installed apps on the simulator with their bundle IDs.

List iOS Simulator devices. Shows name, UDID, state, and runtime.

Simulate movement along a custom route with waypoints. Specify GPS coordinates and speed for realistic location testing.

Run predefined GPS location scenarios (Freeway Drive, City Run, City Bicycle Ride). Simulates realistic movement patterns for testing location features.

Long press at a point on the simulator screen. Useful for context menus, drag-and-drop initiation, etc.

Trigger a simulated memory warning. Apps will receive didReceiveMemoryWarning and can be tested for proper memory cleanup.

Navigate back in the current app. Sends Cmd+[ (standard back navigation). Works in Safari and apps with standard UINavigationController. Workaround for edge-swipe-back gesture limitation.

Get the current network configuration inside the simulator — interfaces, IP addresses, DNS config.

Opens the iOS Simulator application.

Open a URL or deep link in the simulator (e.g., "https://example.com" or "myapp://screen").

Override the simulator status bar: set time, battery, signal bars, carrier name, network type. Use clear=true to reset.

Press a special key (return, escape, delete, tab, arrows, etc.) with optional modifiers (command, shift, option, control).

Read a file from an app's data container. Handles plists (converts to JSON), SQLite databases (shows schema), and text files. Specify path relative to data container.

Start recording the simulator screen to a video file. Use simulator_stop_recording to stop. Supports H.264 and HEVC codecs.

Take a screenshot of the iOS Simulator screen. Returns the image directly for viewing.

Send a push notification to an app. Provide the full APNs payload JSON (e.g., {"aps": {"alert": "Hello"}}).

Switch the simulator between light and dark mode.

Set text on the simulator clipboard. Useful for pasting content into apps.

Set the preferred content size for Dynamic Type testing. Test your app with accessibility text sizes without changing device settings manually.

Enable or disable the Increase Contrast accessibility setting. Test how your app responds to high contrast mode.

Set the simulated GPS location (latitude, longitude). Useful for testing location-based features.

Shut down a running simulator device.

Capture a structured accessibility snapshot of the current screen — like Playwright's browser_snapshot. Returns roles, labels, values, and positions. PREFERRED over screenshots for understanding UI structure and targeting interactions. No vision model needed.

Stop an active video recording and save the file.

Start/read/stop a live log stream. Use action="start" to begin, "read" to get the buffer, "stop" to end. Great for watching app behavior in real-time.