iOS Simulators

v1.0.0Browser Automationstable

📇 🏠 🍎 - A Model Context Protocol (MCP) server that enables LLMs to interact with iOS simulators (iPhone, iPad, etc.) through natural language commands.

claudeclineiosmacosmcp
Share:
304
Stars
0
Downloads
0
Weekly
0/5

What is iOS Simulators?

iOS Simulators is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 🏠 🍎 - a model context protocol (mcp) server that enables llms to interact with ios simulators (iphone, ipad, etc.) through natural language commands.

📇 🏠 🍎 - A Model Context Protocol (MCP) server that enables LLMs to interact with iOS simulators (iPhone, iPad, etc.) through natural language commands.

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 📇 🏠 🍎 - A Model Context Protocol (MCP) server that enables L

Use Cases

Control iOS simulators via natural language.
Automate iPhone and iPad testing.
Enable AI-driven mobile testing.
InditexTech

Maintainer

LicenseApache 2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx ios-simulators-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use iOS Simulators

iOS Simulators MCP is a TypeScript-based MCP server that enables AI models to interact with iOS simulators on macOS through natural language commands, bridging Claude, Cline, Cursor, and other MCP clients to the Facebook IDB (iOS Development Bridge) toolchain. It exposes tools for simulator lifecycle management, app installation and launch, UI interaction (tap, swipe, text input), screenshot capture, video recording, system log retrieval, crash log analysis, location simulation, and permissions management. Mobile developers and QA engineers use it to automate iOS simulator testing and app verification workflows entirely through conversational AI.

Prerequisites

  • macOS operating system (iOS simulators only run on macOS)
  • Xcode installed with iOS simulator runtimes configured (verify with 'xcrun simctl list')
  • Homebrew installed (used to install idb-companion)
  • Node.js v14.0.0 or higher
  • An MCP-compatible AI client such as Claude Desktop, Cline, or Cursor
1

Clone the repository and install dependencies

Clone the mcp-server-simulator-ios-idb repository and install the Node.js dependencies. The repository includes a setup script that handles the idb-companion dependency via Homebrew.

git clone https://github.com/InditexTech/mcp-server-simulator-ios-idb.git
cd mcp-server-simulator-ios-idb
npm install
2

Install idb-companion via Homebrew and fb-idb via pip

The server relies on idb-companion (from Facebook) as the bridge to the iOS simulator. Install it with Homebrew, then install the fb-idb Python client that the server uses to communicate with it.

brew tap facebook/fb
brew install idb-companion
pip3 install fb-idb
3

Build the TypeScript source

Compile the TypeScript source files to generate the dist/ directory that the MCP server entry point lives in.

npm run build
4

Add the MCP server to your AI client configuration

Open your AI client's MCP configuration file and add an entry pointing at the compiled index.js file. Use the absolute path to the dist/index.js in the cloned repository.

{
  "mcpServers": {
    "ios-simulator": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-simulator-ios-idb/dist/index.js"],
      "env": {}
    }
  }
}
5

Restart your AI client and boot a simulator

Restart your AI client to load the new server. Open Xcode Simulator or use the AI to list and boot a device. The AI can then drive the simulator through natural language commands.

iOS Simulators Examples

Client configuration

Claude Desktop configuration for the iOS Simulators MCP server. Replace the path with the absolute path to the dist/index.js file in your cloned repository.

{
  "mcpServers": {
    "ios-simulator": {
      "command": "node",
      "args": ["/Users/me/mcp-server-simulator-ios-idb/dist/index.js"],
      "env": {}
    }
  }
}

Prompts to try

After connecting, use these prompts to control iOS simulators through your AI client.

- "List all available iOS simulator devices"
- "Boot an iPhone 15 simulator"
- "Install the app at /path/to/MyApp.app on the simulator"
- "Launch the app with bundle ID com.example.myapp"
- "Tap at coordinates 200, 400 on the simulator screen"
- "Take a screenshot of the current simulator state"
- "Show me the system logs from the simulator"

Troubleshooting iOS Simulators

idb or idb-companion not found when the server starts

Run 'brew install idb-companion' and 'pip3 install fb-idb' to ensure both components are installed. Verify idb is on your PATH by running 'which idb' in a terminal. If using a virtual environment, activate it before starting the MCP server.

Simulator commands fail with 'no booted device' error

Ask the AI to list available simulators and boot one before issuing UI commands. You can also open Xcode > Simulators and boot a device manually. Ensure Xcode's command-line tools are installed with 'xcode-select --install'.

The MCP server process starts but the AI cannot see any tools

Check that the path in your MCP config points to the compiled dist/index.js and not the src/ TypeScript files. Run 'npm run build' again if the dist/ folder is missing or outdated, then restart your AI client.

Frequently Asked Questions about iOS Simulators

What is iOS Simulators?

iOS Simulators is a Model Context Protocol (MCP) server that 📇 🏠 🍎 - a model context protocol (mcp) server that enables llms to interact with ios simulators (iphone, ipad, etc.) through natural language commands. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install iOS Simulators?

Follow the installation instructions on the iOS Simulators GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with iOS Simulators?

iOS Simulators works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is iOS Simulators free to use?

Yes, iOS Simulators is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "ios-simulators-mcp": { "command": "npx", "args": ["-y", "ios-simulators-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use iOS Simulators?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides