# looktap

> looktap is an open-source MCP server for developer tools. Let an AI agent read an iPhone or Android screen as text and tap by label. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, iOS, Android, macOS
- **Website:** https://lakpriya.com/looktap/
- **Repository:** https://github.com/lakpriya1s/looktap/tree/HEAD/mcp
- **MCP Registry name:** io.github.lakpriya1s/looktap
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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

## 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

- [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/looktap
