# iOS Simulator MCP (MCP server)

> iOS Simulator MCP is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for interacting with the iOS simulator. It has 2,195 GitHub stars, is released under the MIT license and runs locally with npx -y ios-simulator-mcp.

A Model Context Protocol (MCP) server for interacting with iOS simulators. This server allows you to interact with iOS simulators by getting information about them, controlling UI interactions, and inspecting UI elements.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/joshuayoes/ios-simulator-mcp |
| GitHub stars | 2,195 |
| License | MIT |
| Language | JavaScript |
| Transport | stdio |
| Packages | npm: ios-simulator-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | v2.1.0 (Aug 13, 2026) |
| Last commit | Aug 13, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ios-simulator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "env": {
        "FOO": "your-value",
        "BAZ": "your-value",
        "IOS_SIMULATOR_MCP_FILTERED_TOOLS": "your-value",
        "IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR": "your-value",
        "IOS_SIMULATOR_MCP_IDB_PATH": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env FOO=your-value --env BAZ=your-value --env IOS_SIMULATOR_MCP_FILTERED_TOOLS=your-value --env IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR=your-value --env IOS_SIMULATOR_MCP_IDB_PATH=your-value --transport stdio ios-simulator-mcp -- npx -y ios-simulator-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ios-simulator-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "env": {
        "FOO": "your-value",
        "BAZ": "your-value",
        "IOS_SIMULATOR_MCP_FILTERED_TOOLS": "your-value",
        "IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR": "your-value",
        "IOS_SIMULATOR_MCP_IDB_PATH": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ios-simulator-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ios-simulator-mcp"
      ],
      "env": {
        "FOO": "your-value",
        "BAZ": "your-value",
        "IOS_SIMULATOR_MCP_FILTERED_TOOLS": "your-value",
        "IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR": "your-value",
        "IOS_SIMULATOR_MCP_IDB_PATH": "your-value"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `FOO`: Shown in the README's example configuration.
- `BAZ`: Shown in the README's example configuration.
- `IOS_SIMULATOR_MCP_FILTERED_TOOLS`: Shown in the README's example configuration.
- `IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR`: Shown in the README's example configuration.
- `IOS_SIMULATOR_MCP_IDB_PATH`: Shown in the README's example configuration.

## Tools

- `get_booted_sim_id`
- `open_simulator`
- `ui_describe_all`
- `ui_tap`
- `ui_type`
- `ui_swipe`
- `ui_describe_point`
- `ui_find_element`
- `ui_view`
- `screenshot`
- `record_video`
- `stop_recording`
- `install_app`
- `launch_app`
- `terminate_app`
- `open_url`
- `list_apps`

## Similar MCP servers

- [Memanto](https://appsgit.com/mcp-servers/memanto): MCP server for Memanto - persistent semantic memory for any MCP-compatible agent. (2,342 stars, MIT)
- [MCP Gsc](https://appsgit.com/mcp-servers/mcp-gsc): Google Search Console Insights with Claude AI for SEOs. (2,028 stars, MIT, needs API key)
- [Agency Orchestrator](https://appsgit.com/mcp-servers/agency-orchestrator): 🚀 One sentence → your one-person company of AI experts → complete deliverable in minutes. (2,405 stars, Apache-2.0)
- [Tooluniverse](https://appsgit.com/mcp-servers/tooluniverse): 2,700+ scientific tools for AI scientists: life science, research, literature, and more. (1,759 stars, Apache-2.0, needs API key)
- [PaperBanana](https://appsgit.com/mcp-servers/paperbanana): Generate academic diagrams and statistical plots from text using multi-agent AI. (2,419 stars, MIT)
- [Ros MCP Server](https://appsgit.com/mcp-servers/ros-mcp-server): Connect AI models like Claude & ChatGPT with ROS robots using MCP. (1,506 stars, Apache-2.0)

---

Canonical page: https://appsgit.com/mcp-servers/ios-simulator-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.