simulator-use
Build, run and tap through the iOS Simulator from a coding agent
- Pricing
- Open source
- Platforms
- macOS, CLI, iOS
- Runs
- Locally
- Version
- 0.16.0
- Listing updated
- 3 days ago
About simulator-use
simulator-use is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add simulator-use -- npx -y simulator-useAdd to claude_desktop_config.json
{
"mcpServers": {
"simulator-use": {
"command": "npx",
"args": [
"-y",
"simulator-use"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"simulator-use": {
"command": "npx",
"args": [
"-y",
"simulator-use"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"simulator-use": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"simulator-use"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"simulator-use": {
"command": "npx",
"args": [
"-y",
"simulator-use"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"simulator-use": {
"command": "npx",
"args": [
"-y",
"simulator-use"
]
}
}
}Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Open source
Free and open source; optional cloud phone billed per minute
Prices change. Check simulator-use.dev before you buy.
simulator-use 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 to simulator-use

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools