Skip to content
Back to search

ios-simulator-mcp

MCP server for interacting with the iOS simulator

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/joshuayoes--ios-simulator-mcp/badge.svg)](/listings/joshuayoes--ios-simulator-mcp)

HTML

<a href="/listings/joshuayoes--ios-simulator-mcp"><img src="/api/listings/joshuayoes--ios-simulator-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

This section provides instructions for integrating the iOS Simulator MCP server with different Model Context Protocol (MCP) clients.

Installation with Cursor

Cursor manages MCP servers through its configuration file located at `~/.cursor/mcp.json`.

Option 1: Using NPX (Recommended)

1. Edit your Cursor MCP configuration file. You can often open it directly from Cursor or use a command like: ```bash # Open with your default editor (or use 'code', 'vim', etc.) open ~/.cursor/mcp.json # Or use Cursor's command if available # cursor ~/.cursor/mcp.json ``` 2. Add or update the `mcpServers` section with the iOS simulator server configuration: ```json { "mcpServers": { // ... other servers might be listed here ... "ios-simulator": { "command": "npx", "args": ["-y", "ios-simulator-mcp"] } } } ``` Ensure the JSON structure is valid, especially if `mcpServers` already exists.

If you prefer pnpm, use its `dlx` runner instead:

```json { "mcpServers": { "ios-simulator": { "command": "pnpm", "args": ["dlx", "ios-simulator-mcp"] } } } ```

3. Restart Cursor for the changes to take effect.

Option 2: Local Development

1. Clone this repository: ```bash git clone https://github.com/joshuayoes/ios-simulator-mcp cd ios-simulator-mcp ``` 2. Install dependencies (npm is the default; pnpm is also supported): ```bash npm install # or, using pnpm (installs from the committed pnpm-lock.yaml): pnpm install ``` 3. Build the project: ```bash npm run build # or: pnpm run build ``` 4. Edit your Cursor MCP configuration file (as shown in Option 1). 5. Add or update the `mcpServers` section, pointing to your local build: ```json { "mcpServers": { // ... other servers might be listed here ... "ios-simulator": { "command": "node", "args": ["/full/path/to/your/ios-simulator-mcp/build/index.js"] } } } ``` **Important:** Replace `/full/path/to/your/` with the absolute path to where you cloned the `ios-simulator-mcp` repository. 6. Restart Cursor for the changes to take effect.

Installation with Claude Code

Claude Code CLI can manage MCP servers using the `claude mcp` commands or by editing its configuration files directly. For more details on Claude Code MCP configuration, refer to the [official documentation](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp).

Option 1: Using NPX (Recommended)

1. Add the server using the `claude mcp add` command: ```bash claude mcp add ios-simulator npx ios-simulator-mcp # or, with pnpm: claude mcp add ios-simulator -- pnpm dlx ios-simulator-mcp ``` 2. Restart any running Claude Code sessions if necessary.

Option 2: Local Development

1. Clone this repository, install dependencies, and build the project as described in the Cursor "Local Development" steps 1-3. 2. Add the server using the `claude mcp add` command, pointing to your local build: ```bash claude mcp add ios-simulator -- node "/full/path/to/your/ios-simulator-mcp/build/index.js" ``` **Important:** Replace `/full/path/to/your/` with the absolute path to where you cloned the `ios-simulator-mcp` repository. 3. Restart any running Claude Code sessions if necessary.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 615 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # iOS Simulator MCP Server
  2. [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=ios-simulator&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImlvcy1zaW11bGF0b3ItbWNwIl19) [![NPM Version](https://img.shields.io/npm/v/ios-simulator-mcp)](https://www.npmjs.com/package/ios-simulator-mcp)
  3. 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.
  4. > **Security Notice**: Command injection vulnerabilities present in versions < 1.3.3 have been fixed. Please update to v1.3.3 or later. See [SECURITY.md](SECURITY.md) for details.
  5. https://github.com/user-attachments/assets/a88e449c-8f1d-46a5-9816-0f97e071c460
  6. ## 🌟 Featured In
  7. This project has been featured and mentioned in various publications and resources:
  8. - [Claude Code Best Practices article](https://www.anthropic.com/engineering/claude-code-best-practices#:~:text=Write%20code%2C%20screenshot%20result%2C%20iterate) - Anthropic's engineering blog showcasing best practices
  9. - [React Native Newsletter Issue 187](https://us3.campaign-archive.com/?u=78d9e37a94fa0b522939163d4&id=656ed2c2cf#:~:text=iOS%20Simulator%20MCP%20Server) - Featured in the most popular React Native community newsletter
  10. - [Mobile Automation Newsletter - #56](https://testableapple.com/newsletter/56/#:~:text=iOS-,iOS%20Simulator%20MCP,-%F0%9F%8E%99%EF%B8%8F%20Joshua%20Yoes) - Featured a long running newsletter about mobile testing and automation resources
  11. - [punkeye/awesome-mcp-server listing](https://github.com/punkpeye/awesome-mcp-servers) - Listed in one of the most popular curated awesome MCP servers collection
  12. ## Tools
  13. ### `get_booted_sim_id`
  14. **Description:** Get the ID of the currently booted iOS simulator
  15. **Parameters:** No Parameters
  16. ### `open_simulator`
  17. **Description:** Opens the iOS Simulator application
  18. **Parameters:** No Parameters
  19. ### `ui_describe_all`
  20. **Description:** Describes accessibility information for the entire screen in the iOS Simulator
  21. **Parameters:**
  22. ```typescript
  23. {
  24. /**
  25. * Udid of target, can also be set with the IDB_UDID env var
  26. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  27. */
  28. udid?: string;
  29. }
  30. ```
  31. ### `ui_tap`
  32. **Description:** Tap on the screen in the iOS Simulator
  33. **Parameters:**
  34. ```typescript
  35. {
  36. /**
  37. * Press duration in seconds (decimal numbers allowed)
  38. */
  39. duration?: string;
  40. /**
  41. * Udid of target, can also be set with the IDB_UDID env var
  42. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  43. */
  44. udid?: string;
  45. /** The x-coordinate */
  46. x: number;
  47. /** The y-coordinate */
  48. y: number;
  49. }
  50. ```
  51. ### `ui_type`
  52. **Description:** Input text into the iOS Simulator
  53. **Parameters:**
  54. ```typescript
  55. {
  56. /**
  57. * Udid of target, can also be set with the IDB_UDID env var
  58. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  59. */
  60. udid?: string;
  61. /**
  62. * Text to input
  63. * Format: up to 500 characters; ASCII printable characters only (method "type")
  64. */
  65. text: string;
  66. /**
  67. * "type" (default) or "paste"
  68. */
  69. method?: "type" | "paste";
  70. /**
  71. * Method "paste" only: clear the focused field first (default false)
  72. */
  73. replace?: boolean;
  74. }
  75. ```
  76. `method: "type"` (the default) presses keys as on a US keyboard, so on other layouts such as French AZERTY it types the wrong characters (`mobiletest@example.com` becomes `,obiletest2exq,ple:co,`). Use `method: "paste"` for non-US keyboard layouts or non-ASCII text; it takes a few seconds per call instead of about 230 ms: about 2 s (about 5 s with `replace: true`) when iOS doesn't ask to allow pasting, and up to about 11 s when it does (seen on iOS 26.5 and 27). Tap the text field first: the text is pasted into the focused field through the simulator pasteboard, iOS's "Allow Paste" prompt is tapped for you, and the field is read back to confirm (for secure fields, only the length). Some simulator runtimes (seen on iOS 27.2) cannot show that prompt, so Cmd+V pastes nothing; the text is then pasted with the Paste item of the field's edit menu, which takes about 8 to 13 s per call (longer when it fails) and, where the Menu key opens no edit menu (web fields), taps the end of the field's first line, with a warning when the text then did not land at the end. The previous pasteboard text is restored afterwards (non-text content such as an image is not), unless the prompt is still on screen when the call gives up; then the text stays on the pasteboard and the error tells you to tap the allow button instead of retrying. `replace: true` clears the field first (e.g. after `"type"` produced wrong characters). Paste mode rejects empty text and newlines. It needs fb-idb 1.5.1+ and a recent idb_companion (1.1.8 lacks `--api axbridge`, so every paste fails with "No focused text field found"; `brew upgrade idb-companion`, then `idb kill`).
  77. ### `ui_swipe`
  78. **Description:** Swipe on the screen in the iOS Simulator
  79. **Parameters:**
  80. ```typescript
  81. {
  82. /**
  83. * Swipe duration in seconds (decimal numbers allowed)
  84. */
  85. duration?: string;
  86. /**
  87. * Udid of target, can also be set with the IDB_UDID env var
  88. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  89. */
  90. udid?: string;
  91. /** The starting x-coordinate */
  92. x_start: number;
  93. /** The starting y-coordinate */
  94. y_start: number;
  95. /** The ending x-coordinate */
  96. x_end: number;
  97. /** The ending y-coordinate */
  98. y_end: number;
  99. /** The size of each step in the swipe (default is 1) */
  100. delta?: number;
  101. }
  102. ```
  103. ### `ui_describe_point`
  104. **Description:** Returns the accessibility element at given co-ordinates on the iOS Simulator's screen
  105. **Parameters:**
  106. ```typescript
  107. {
  108. /**
  109. * Udid of target, can also be set with the IDB_UDID env var
  110. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  111. */
  112. udid?: string;
  113. /** The x-coordinate */
  114. x: number;
  115. /** The y-coordinate */
  116. y: number;
  117. }
  118. ```
  119. ### `ui_find_element`
  120. **Description:** Searches the accessibility tree and returns elements matching the given criteria
  121. **Parameters:**
  122. ```typescript
  123. {
  124. /** Array of search strings. An element matches if ANY string matches against its AXLabel or AXUniqueId */
  125. search: string[];
  126. /** Filter by element type (e.g. 'Button', 'StaticText', 'Group'). Case-insensitive exact match */
  127. type?: string;
  128. /** Match mode: 'substring' (default) or 'exact' */
  129. matchMode?: "substring" | "exact";
  130. /** Whether search matching is case-sensitive (default: false) */
  131. caseSensitive?: boolean;
  132. /**
  133. * Udid of target, can also be set with the IDB_UDID env var
  134. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  135. */
  136. udid?: string;
  137. }
  138. ```
  139. ### `ui_view`
  140. **Description:** Get the image content of a compressed screenshot of the current simulator view
  141. **Parameters:**
  142. ```typescript
  143. {
  144. /**
  145. * Udid of target, can also be set with the IDB_UDID env var
  146. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  147. */
  148. udid?: string;
  149. }
  150. ```
  151. ### `screenshot`
  152. **Description:** Takes a screenshot of the iOS Simulator
  153. **Parameters:**
  154. ```typescript
  155. {
  156. /**
  157. * Udid of target, can also be set with the IDB_UDID env var
  158. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  159. */
  160. udid?: string;
  161. /** File path where the screenshot will be saved. If relative, it uses the directory specified by the `IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR` env var, or `~/Downloads` if not set. */
  162. output_path: string;
  163. /** Image format (png, tiff, bmp, gif, or jpeg). Default is png. */
  164. type?: "png" | "tiff" | "bmp" | "gif" | "jpeg";
  165. /** Display to capture (internal or external). Default depends on device type. */
  166. display?: "internal" | "external";
  167. /** For non-rectangular displays, handle the mask by policy (ignored, alpha, or black) */
  168. mask?: "ignored" | "alpha" | "black";
  169. }
  170. ```
  171. ### `record_video`
  172. **Description:** Records a video of the iOS Simulator using simctl directly
  173. **Parameters:**
  174. ```typescript
  175. {
  176. /**
  177. * Udid of target, can also be set with the IDB_UDID env var
  178. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  179. */
  180. udid?: string;
  181. /** Optional output path. If not provided, a default name will be used. The file will be saved in the directory specified by `IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR` or in `~/Downloads` if the environment variable is not set. */
  182. output_path?: string;
  183. /** Specifies the codec type: "h264" or "hevc". Default is "hevc". */
  184. codec?: "h264" | "hevc";
  185. /** Display to capture: "internal" or "external". Default depends on device type. */
  186. display?: "internal" | "external";
  187. /** For non-rectangular displays, handle the mask by policy: "ignored", "alpha", or "black". */
  188. mask?: "ignored" | "alpha" | "black";
  189. /** Force the output file to be written to, even if the file already exists. */
  190. force?: boolean;
  191. }
  192. ```
  193. ### `stop_recording`
  194. **Description:** Stops the simulator video recording using killall
  195. **Parameters:** No Parameters
  196. ### `install_app`
  197. **Description:** Installs an app bundle (.app or .ipa) on the iOS Simulator
  198. **Parameters:**
  199. ```typescript
  200. {
  201. /**
  202. * Udid of target, can also be set with the IDB_UDID env var
  203. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  204. */
  205. udid?: string;
  206. /** Path to the app bundle (.app directory or .ipa file) to install */
  207. app_path: string;
  208. }
  209. ```
  210. ### `launch_app`
  211. **Description:** Launches an app on the iOS Simulator by bundle identifier
  212. **Parameters:**
  213. ```typescript
  214. {
  215. /**
  216. * Udid of target, can also be set with the IDB_UDID env var
  217. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  218. */
  219. udid?: string;
  220. /** Bundle identifier of the app to launch (e.g., com.apple.mobilesafari) */
  221. bundle_id: string;
  222. /** Terminate the app if it is already running before launching */
  223. terminate_running?: boolean;
  224. /** Optional environment variables passed via SIMCTL_CHILD_ to simctl launch */
  225. env?: Record<string, string>;
  226. }
  227. ```
  228. **Notes:** Environment variables are passed using `SIMCTL_CHILD_` because `simctl launch` does not support `--env/--envs` on all Xcode versions.
  229. **Example:**
  230. ```json
  231. {
  232. "bundle_id": "com.example.app",
  233. "terminate_running": true,
  234. "env": {
  235. "FOO": "bar",
  236. "BAZ": "qux"
  237. }
  238. }
  239. ```
  240. ### `terminate_app`
  241. **Description:** Terminates a running app on the iOS Simulator by bundle identifier. Useful for testing cold-start flows and verifying crash recovery without reinstalling the app.
  242. **Parameters:**
  243. ```typescript
  244. {
  245. /**
  246. * Udid of target, can also be set with the IDB_UDID env var
  247. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  248. */
  249. udid?: string;
  250. /** Bundle identifier of the app to terminate (e.g., com.apple.mobilesafari) */
  251. bundle_id: string;
  252. }
  253. ```
  254. ### `open_url`
  255. **Description:** Opens a URL or deep link in the iOS Simulator. Handles `https://` URLs (via Safari), custom URL schemes, and universal links — essential for testing deep-link routing and OAuth redirect flows.
  256. **Parameters:**
  257. ```typescript
  258. {
  259. /**
  260. * Udid of target, can also be set with the IDB_UDID env var
  261. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  262. */
  263. udid?: string;
  264. /** The URL or deep link to open (e.g., https://example.com or myapp://screen/detail) */
  265. url: string;
  266. }
  267. ```
  268. ### `list_apps`
  269. **Description:** Lists all installed apps on the iOS Simulator with their bundle identifiers and display names, sorted alphabetically. Removes the need to look up bundle IDs manually before calling `launch_app` or `terminate_app`.
  270. **Parameters:**
  271. ```typescript
  272. {
  273. /**
  274. * Udid of target, can also be set with the IDB_UDID env var
  275. * Format: UUID (8-4-4-4-12 hexadecimal characters)
  276. */
  277. udid?: string;
  278. }
  279. ```
  280. ## 💡 Use Case: QA Step via MCP Tool Calls
  281. This MCP server allows AI assistants integrated with a Model Context Protocol (MCP) client to perform Quality Assurance tasks by making tool calls. This is useful immediately after implementing features to help ensure UI consistency and correct behavior.
  282. ### How to Use
  283. After a feature implementation, instruct your AI assistant within its MCP client environment to use the available tools. For example, in Cursor's agent mode, you could use the prompts below to quickly validate and document UI interactions.
  284. ### Example Prompts
  285. - **Verify UI Elements:**
  286. ```
  287. Verify all accessibility elements on the current screen
  288. ```
  289. - **Confirm Text Input:**
  290. ```
  291. Enter "QA Test" into the text input field and confirm the input is correct
  292. ```
  293. - **Check Tap Response:**
  294. ```
  295. Tap on coordinates x=250, y=400 and verify the expected element is triggered
  296. ```
  297. - **Validate Swipe Action:**
  298. ```
  299. Swipe from x=150, y=600 to x=150, y=100 and confirm correct behavior
  300. ```
  301. - **Detailed Element Check:**
  302. ```
  303. Describe the UI element at position x=300, y=350 to ensure proper labeling and functionality
  304. ```
  305. - **Show Your AI Agent the Simulator Screen:**
  306. ```
  307. View the current simulator screen
  308. ```
  309. - **Take Screenshot:**
  310. ```
  311. Take a screenshot of the current simulator screen and save it to my_screenshot.png
  312. ```
  313. - **Record Video:**
  314. ```
  315. Start recording a video of the simulator screen (saves to the default output directory, which is `~/Downloads` unless overridden by `IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR`)
  316. ```
  317. - **Stop Recording:**
  318. ```
  319. Stop the current simulator screen recording
  320. ```
  321. - **Install App:**
  322. ```
  323. Install the app at path/to/MyApp.app on the simulator
  324. ```
  325. - **Launch App:**
  326. ```
  327. Launch the Safari app (com.apple.mobilesafari) on the simulator
  328. ```
  329. ## 🧭 Tip: Deep Link Straight to a Screen
  330. Agents can waste a lot of iterations tapping and swiping their way to a deeply
  331. nested route. When your app registers a URL scheme (or Universal Link), it's
  332. usually faster to jump directly to the target screen instead of navigating there
  333. step by step.
  334. You can open a deep link with [`uri-scheme`](https://www.npmjs.com/package/uri-scheme):
  335. ```bash
  336. npx uri-scheme open "myapp://products/42" --ios
  337. ```
  338. This targets the currently booted simulator. Under the hood it's equivalent to:
  339. ```bash
  340. xcrun simctl openurl booted "myapp://products/42"
  341. ```
  342. Both work for custom schemes (`myapp://...`) and web URLs (`https://...`, which
  343. trigger Universal Links if your app is configured for them).
  344. **Example prompt:**
  345. ```
  346. Open the deep link myapp://products/42 in the simulator, then verify the product
  347. details screen is shown
  348. ```
  349. Use this to shorten agent loops: deep link to the screen under test, then use the
  350. UI tools (`ui_describe_all`, `ui_tap`, `ui_view`, …) to validate it.
  351. ## Prerequisites
  352. - Node.js 20 or later
  353. - macOS (as iOS simulators are only available on macOS)
  354. - [Xcode](https://developer.apple.com/xcode/resources/) and iOS simulators installed
  355. - Facebook [IDB](https://fbidb.io/) tool: the `idb_companion` binary plus the `fb-idb` Python client. See [TROUBLESHOOTING.md](TROUBLESHOOTING.md#2-installing-idb) for install steps, and [`ui_type`](#ui_type) for the versions `method: "paste"` needs
  356. ## Installation
  357. This section provides instructions for integrating the iOS Simulator MCP server with different Model Context Protocol (MCP) clients.
  358. ### Installation with Cursor
  359. Cursor manages MCP servers through its configuration file located at `~/.cursor/mcp.json`.
  360. #### Option 1: Using NPX (Recommended)
  361. 1. Edit your Cursor MCP configuration file. You can often open it directly from Cursor or use a command like:
  362. ```bash
  363. # Open with your default editor (or use 'code', 'vim', etc.)
  364. open ~/.cursor/mcp.json
  365. # Or use Cursor's command if available
  366. # cursor ~/.cursor/mcp.json
  367. ```
  368. 2. Add or update the `mcpServers` section with the iOS simulator server configuration:
  369. ```json
  370. {
  371. "mcpServers": {
  372. // ... other servers might be listed here ...
  373. "ios-simulator": {
  374. "command": "npx",
  375. "args": ["-y", "ios-simulator-mcp"]
  376. }
  377. }
  378. }
  379. ```
  380. Ensure the JSON structure is valid, especially if `mcpServers` already exists.
  381. If you prefer pnpm, use its `dlx` runner instead:
  382. ```json
  383. {
  384. "mcpServers": {
  385. "ios-simulator": {
  386. "command": "pnpm",
  387. "args": ["dlx", "ios-simulator-mcp"]
  388. }
  389. }
  390. }
  391. ```
  392. 3. Restart Cursor for the changes to take effect.
  393. #### Option 2: Local Development
  394. 1. Clone this repository:
  395. ```bash
  396. git clone https://github.com/joshuayoes/ios-simulator-mcp
  397. cd ios-simulator-mcp
  398. ```
  399. 2. Install dependencies (npm is the default; pnpm is also supported):
  400. ```bash
  401. npm install
  402. # or, using pnpm (installs from the committed pnpm-lock.yaml):
  403. pnpm install
  404. ```
  405. 3. Build the project:
  406. ```bash
  407. npm run build
  408. # or:
  409. pnpm run build
  410. ```
  411. 4. Edit your Cursor MCP configuration file (as shown in Option 1).
  412. 5. Add or update the `mcpServers` section, pointing to your local build:
  413. ```json
  414. {
  415. "mcpServers": {
  416. // ... other servers might be listed here ...
  417. "ios-simulator": {
  418. "command": "node",
  419. "args": ["/full/path/to/your/ios-simulator-mcp/build/index.js"]
  420. }
  421. }
  422. }
  423. ```
  424. **Important:** Replace `/full/path/to/your/` with the absolute path to where you cloned the `ios-simulator-mcp` repository.
  425. 6. Restart Cursor for the changes to take effect.
  426. ### Installation with Claude Code
  427. Claude Code CLI can manage MCP servers using the `claude mcp` commands or by editing its configuration files directly. For more details on Claude Code MCP configuration, refer to the [official documentation](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp).
  428. #### Option 1: Using NPX (Recommended)
  429. 1. Add the server using the `claude mcp add` command:
  430. ```bash
  431. claude mcp add ios-simulator npx ios-simulator-mcp
  432. # or, with pnpm:
  433. claude mcp add ios-simulator -- pnpm dlx ios-simulator-mcp
  434. ```
  435. 2. Restart any running Claude Code sessions if necessary.
  436. #### Option 2: Local Development
  437. 1. Clone this repository, install dependencies, and build the project as described in the Cursor "Local Development" steps 1-3.
  438. 2. Add the server using the `claude mcp add` command, pointing to your local build:
  439. ```bash
  440. claude mcp add ios-simulator -- node "/full/path/to/your/ios-simulator-mcp/build/index.js"
  441. ```
  442. **Important:** Replace `/full/path/to/your/` with the absolute path to where you cloned the `ios-simulator-mcp` repository.
  443. 3. Restart any running Claude Code sessions if necessary.
  444. ## Configuration
  445. ### Environment Variables
  446. | Variable | Description | Example |
  447. | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
  448. | `IOS_SIMULATOR_MCP_FILTERED_TOOLS` | A comma-separated list of tool names to filter out from being registered. | `screenshot,record_video,stop_recording` |
  449. | `IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR` | Specifies a default directory for output files like screenshots and video recordings. If not set, `~/Downloads` will be used. This can be handy if your agent has limited access to the file system. | `~/Code/awesome-project/tmp` |
  450. | `IOS_SIMULATOR_MCP_IDB_PATH` | Specifies a custom path to the IDB executable. If not set, `idb` will be used (assuming it's in your PATH). Useful if IDB is installed in a non-standard location. | `~/bin/idb` or `/usr/local/bin/idb` |
  451. #### Configuration Example
  452. ```json
  453. {
  454. "mcpServers": {
  455. "ios-simulator": {
  456. "command": "npx",
  457. "args": ["-y", "ios-simulator-mcp"],
  458. "env": {
  459. "IOS_SIMULATOR_MCP_FILTERED_TOOLS": "screenshot,record_video,stop_recording",
  460. "IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR": "~/Code/awesome-project/tmp",
  461. "IOS_SIMULATOR_MCP_IDB_PATH": "~/bin/idb"
  462. }
  463. }
  464. }
  465. }
  466. ```
  467. ## MCP Registry Server Listings
  468. <a href="https://glama.ai/mcp/servers/@joshuayoes/ios-simulator-mcp">
  469. <img width="380" height="200" src="https://glama.ai/mcp/servers/@joshuayoes/ios-simulator-mcp/badge" alt="iOS Simulator MCP server" />
  470. </a>
  471. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/joshuayoes-ios-simulator-mcp-badge.png)](https://mseep.ai/app/joshuayoes-ios-simulator-mcp)
  472. ## License
  473. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.