mcpbeat Sign in

simulator-use MCP Server

local only

simulator-use runs on your own machine — the client starts it, so there is no endpoint to ping. 1 907 installs a week from npm. Last commit 2 Nov 2026.

The iOS Simulator for coding agents: build Xcode projects, read the screen as text, tap by label.

Installs per day peak 514 · avg 45
a month agotoday
1 907
Installs / week
npm · simulator-use
5
Stars
0 open issues
2 Nov 2026
Last commit
16 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 1 d ago · rules 995398eba69f

A tool parameter reaches a dangerous call

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

A tool parameter reaches a dangerous call app_control.device → src/tools/screen-record.ts:53, app_control.device → src/tools/screen-record.ts:59
      const child = spawn("xcrun", ["simctl", "io", device.udid, "recordVideo", "--codec=h264", "--force", file], { detached: true, stdio: "ignore" });
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    execFile(file, args, { timeout: options.timeoutMs ?? 30_000, maxBuffer: options.maxBytes ?? 64 * 1024 * 1024, encoding: "utf8", ...(options.env ? { env: options.env } : {}) }, (error, stdout, stderr) => {
Runs an external command native/engine/main.swift:212
    let process = Process()
Reads files and sends them to the network src/cloud/sync.ts:12, src/hosted.ts:452
import { createReadStream, lstatSync, readdirSync, realpathSync, type Stats } from "node:fs";
Page executes code built at runtime site/index.html:378
    const s = document.createElement("span"); s.className = "ln"; s.innerHTML = html;

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add simulator-use -- npx -y simulator-use
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.simulator-use]
command = "npx"
args = ["-y", "simulator-use"]
.cursor/mcp.json
{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "simulator-use": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}

Alternatives to simulator-use

same job, measured the same way
NoMac Simulator
by nomac

Cloud iPhone Simulators for AI agents: build the Xcode project, read the screen, tap by label, test.

answering
NoMac
by nomac

Cloud iPhones and Macs with Xcode for AI agents: build, run and test iOS apps, use the screen.

answering
looktap
by lakpriya1s

Let your AI agent see, use and control the apps on your phone: screen as text, tap by label.

159 installs/wk local only
Testa
by valewnrt

Drive the iOS Simulator from an agent: read the screen, tap/type/swipe, replay flows in CI.

41 installs/wk local only
NoMac Session
by nomac

The cloud Mac alone, with Xcode, for AI agents: run commands, build and test, use the screen.

answering
macbox
by opslane

A real Mac for your agent: build, test, run, and tap through iOS apps on the simulator.

47 installs/wk local only
A
AppContext
by appcontext

Live iOS Simulator and browser screenshots, logs, and a personal MCP hub for AI coding agents.

95 installs/wk local only
Ramus Android
by ramus

Disposable cloud Android emulators for coding agents: run an APK or PR build, tap, type, screenshot.

answering

simulator-use — questions

Answers built from our own checks of this server.

Why is there no uptime for simulator-use?
simulator-use runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package simulator-use was installed 1 907 times last week.
How do I connect simulator-use?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls simulator-use straight from npm; nothing to host, nothing to sign up for.
How many people use simulator-use?
The npm package simulator-use was installed 1 907 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is simulator-use open source?
Yes — it is published under the MIT licence, written in TypeScript and 5 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.