Skip to content
MCP server

simframe

Fast iOS Simulator and Android emulator screen reading, taps and flows for coding agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS
Runs
Locally
Version
0.23.1
Listing updated
1 day ago

About simframe

simframe is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

An agent driving a simulator is slow for three reasons the project names: every look is a wait, every step is a round trip, and nothing is remembered. simframe keeps frames warm so a look takes about 20 ms, compares changes against the last frame the agent actually observed (not the previous frame, which would miss a 700 ms transition), and can run a whole multi-step flow in one call.

It reads each screen two ways: the accessibility tree for real hit targets, and on-device OCR through Apple's Vision for every visible label with coordinates. The merged result is keyed by a layout hash, so revisiting a screen is a file read. The authors tested on a React Native app whose custom tab bar published no children and found this was needed.

In one measured run on that app, the same model with simframe used 2.5 times fewer tokens and 3.5 times fewer calls, though the agent was still 9 to 10 times slower than a person. Watching needs only Xcode; tapping and typing need idb. Install with npx -y simframe mcp on a Mac with Node 18 or newer; the first call builds a small Swift daemon in about 15 seconds. Capture stops itself 15 minutes after the last request.

Install

Run in a terminal

claude mcp add simframe -- npx -y simframe

Add to claude_desktop_config.json

{
  "mcpServers": {
    "simframe": {
      "command": "npx",
      "args": [
        "-y",
        "simframe"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "simframe": {
      "command": "npx",
      "args": [
        "-y",
        "simframe"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "simframe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "simframe"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "simframe": {
      "command": "npx",
      "args": [
        "-y",
        "simframe"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "simframe": {
      "command": "npx",
      "args": [
        "-y",
        "simframe"
      ]
    }
  }
}

What it does

Warm frames
Keeps screen capture running so reads take about 20 ms.
Change baselines
Reports what changed since the last frame the agent saw.
One-call flows
Runs a multi-step flow in a single tool call.
OCR plus accessibility
Merges visible labels with accessibility targets.
Screen memory
Remembers screens by layout hash so repeat visits are quick.
Claude Code plugin
Optionally installs a Sonnet-driven driver agent and skill.

Good for

  • Let an agent tap through a signup flow in the iOS Simulator
  • Check whether a list on a tab has finished loading
  • Debug why a button does nothing
  • Cut token use when testing a mobile app with an agent

Pricing

Open source

Open source on GitHub and npm

Prices change. Check lvlrsajjad.github.io before you buy.

simframe FAQ

What does it need?

A Mac with Xcode and Node 18 or newer; tap, type and swipe also need idb.

How is it installed?

claude mcp add --scope user simframe -- npx -y simframe mcp, or as a Claude Code plugin.

How much does it save?

In one benchmarked run, 2.5 times fewer tokens and 3.5 times fewer calls than the same model without it; the README calls it a measured example, not a rate.

Does it support Android?

The README says it drives an iOS Simulator or an Android emulator.

Is simframe free?

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

How do I add simframe to Claude Code?

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

What are the best alternatives to simframe?

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

Alternatives to simframe

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools