joshuayoes/ios-simulator-mcp

MCP server for interacting with the iOS simulator

What it solves

This project provides a way for AI assistants to interact with and control iOS simulators. It eliminates the need for manual testing and navigation by allowing an AI agent to programmatically perform UI interactions, inspect accessibility trees, and manage apps on a simulated iOS device.

How it works

It is implemented as a Model Context Protocol (MCP) server. It exposes a set of tools that an MCP-compatible client (like Cursor or Claude Code) can call to execute commands on the iOS simulator. It leverages the Facebook IDB tool and simctl to perform actions such as tapping, swiping, typing, and taking screenshots.

Who it’s for

Developers and QA engineers working on iOS applications who want to automate UI testing and validation using AI agents.

Highlights

  • UI Interaction: Supports tapping, swiping, and text input.
  • UI Inspection: Can describe the entire screen's accessibility information or find specific elements based on search criteria.
  • Visual Validation: Capable of taking screenshots and recording videos of the simulator screen.
  • App Management: Allows installing, launching, and terminating apps via bundle identifiers.
  • Deep Linking: Supports opening URLs and custom deep links to jump directly to specific app screens.
  • Cros-Client Support: Integrates with MCP clients like Cursor and Claude Code.

Related

  • Project
  • Project
  • Project
  • Project
  • Project