Skip to content
MCP server

looktap

Let an AI agent read an iPhone or Android screen as text and tap by label

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, iOS, Android
Runs
Locally
Version
0.7.1
Listing updated
2 days ago

About looktap

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

Instead of screenshots, looktap lists what is on screen as text, one row per element with a reference, type, position and label, and acts by label. It targets iPhone and Android simulators, emulators and real phones, and what worked in an agent session can then become a script or a CI test.

The site quotes about 1 KB per screen read and 0.1 s per tap, and publishes a benchmark against eight other mobile agent tools. The MCP tools include ls, tap, tap_xy, long_press, fill, type, key, swipe, scroll_to, back, home, wait, screenshot, logs, crashes and perf, plus a looktap tool for other commands such as boot, devices, launch and test. Actions return the settled screen unless turned off.

It needs Node 18 or newer, macOS with Xcode for iPhone and adb for Android. The MCP package is a thin starter that installs the CLI, and the project is AGPL-3.0-only.

Install

Run in a terminal

claude mcp add looktap -- npx -y @looktap/mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "looktap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@looktap/mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "looktap": {
      "command": "npx",
      "args": [
        "-y",
        "@looktap/mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "looktap": {
      "command": "npx",
      "args": [
        "-y",
        "@looktap/mcp"
      ]
    }
  }
}

Tools this server provides (18)

Taken from the project documentation; the running server may differ.

ls
List on-screen elements
tap
Tap an element by label
tap_xy
Tap coordinates
long_press
Long press an element
fill
Fill a field
type
Type text
key
Press a key
hide_keyboard
Hide the keyboard
swipe
Swipe
scroll_to
Scroll to an element
back
Go back
home
Go to the home screen
wait
Wait
screenshot
Return a screenshot image
logs
Read device logs
crashes
Read crashes
perf
CPU, memory, threads or frame jank
looktap
Run any other looktap command

What it does

Screen as text
Lists on-screen elements with reference, type, position and label.
Tap by label
Taps, types, swipes and long-presses without coordinates.
iPhone and Android
Simulators, emulators and real devices.
Logs and perf
Reads logs, crashes, CPU, memory and frame jank.
Scripts and tests
Turns a working run into a script or CI test.
Agent skill install
Installs a skill for several coding agents.

Good for

  • Have an agent walk through an app's sign-up flow
  • Debug a crash by reading logs after a tap sequence
  • Turn an exploratory run into a CI test
  • Check an app on a real device from a coding agent

Pricing

Open source

AGPL-3.0-only

Prices change. Check lakpriya.com before you buy.

looktap FAQ

What do I need installed?

Node 18+, plus Xcode on macOS for iPhone or adb for Android.

How do I add it to Claude Code?

Run claude mcp add looktap -- npx -y @looktap/mcp.

What licence is it?

AGPL-3.0-only.

Does it work on real phones?

Yes. The README covers simulators, emulators and real iPhone and Android devices.

Is looktap free?

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

How do I add looktap to Claude Code?

Run this command in your terminal: claude mcp add looktap -- npx -y @looktap/mcp

What are the best alternatives to looktap?

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

Alternatives to looktap

  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