# simulator-use

> simulator-use is an open-source MCP server for developer tools. Build, run and tap through the iOS Simulator from a coding agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI, iOS
- **Website:** https://simulator-use.dev
- **Repository:** https://github.com/nomac-app/simulator-use
- **MCP Registry name:** app.nomac/simulator-use
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Rather than screenshots, the agent reads the screen as a few lines of text and taps or fills fields by label or id. A sample sign-in screen costs about 70 tokens, against roughly 40,000 for the full accessibility tree. One engine per Simulator keeps input, accessibility and screen buffer open between calls.

Steps such as tapping, filling, scrolling, swiping and waiting go through one action tool that answers with what changed and checks typed text by reading it back. Other tools build and launch Xcode projects with file:line errors, run XCTest and XCUITest cases, and handle installs, deep links, permissions, location, push and logs.

It runs on a Mac with Xcode and Node 20, and nothing leaves the machine unless you enable cloud mode. Without a Mac, a cloud iPhone run by NoMac is billed per minute.

## Features

- **Screen as text:** Compact output instead of screenshots.
- **Tap by label:** Interact using labels and ids.
- **Xcode build and run:** Builds projects and reports errors as file:line.
- **Test runner:** Runs XCTest and XCUITest case by case.
- **Cloud iPhone option:** Use a remote Simulator from Linux, Windows or CI.

## Good for

- Let an agent verify a UI change in the Simulator
- Reproduce a sign-in failure and read the log
- Run unit tests from a coding session
- Test pull requests on a cloud phone in CI

## Install

### Claude Code (Terminal)

```sh
claude mcp add simulator-use -- npx -y simulator-use
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "simulator-use": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}
```

## Tools

- `ui_look`: Reads the current screen as text.
- `ui_act`: Runs tap, fill, scroll, swipe and wait steps and reports what changed.
- `screenshot_file`: Saves the screen at full resolution as a PNG.

## FAQ

### What does it need locally?

A Mac with Xcode and Node 20.

### Is it free?

The site calls it free and open source; cloud use is billed per minute with no subscription.

### Does data leave my Mac?

Not unless you turn on cloud.

### Which clients work?

Claude Code, Codex, Cursor or any MCP client.

### Is simulator-use free?

Yes. simulator-use is open source, so you can use and self-host it for free.

### How do I add simulator-use to Claude Code?

Run this command in your terminal: claude mcp add simulator-use -- npx -y simulator-use

### What are the best alternatives to simulator-use?

The closest alternatives to simulator-use are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/simulator-use
