claude-in-mobile

Claude Mobile

MCP server for mobile and desktop automation — Android (via ADB), iOS Simulator (via simctl), Desktop (Compose Multiplatform), and Aurora OS (via audb). Like Claude in Chrome but for mobile devices and desktop apps.

Control your Android phone, emulator, iOS Simulator, Desktop applications, or Aurora OS device with natural language through Claude.

Features

• Unified API — Same commands work for Android, iOS, Desktop, and Aurora OS
• Smart screenshots — Auto-compressed for optimal LLM processing (no more oversized images!)
• Annotated screenshots — Screenshots with colored bounding boxes and numbered element labels for visual UI understanding
• Permission management — Grant, revoke, and reset app permissions programmatically (Android runtime permissions, iOS privacy services)
• Device logs — Read logcat/system logs with filters for debugging
• UI interactions — Tap, long press, swipe by coordinates or element text
• Text input — Type into focused fields
• App control — Launch, stop, and install apps
• Platform selection — Explicitly target Android, iOS, Desktop, or Aurora OS
• Desktop support — Test Compose Multiplatform desktop apps with window management, clipboard, and performance metrics

Installation

One-liner (any client)

Using add-mcp — auto-detects installed clients:

npx add-mcp claude-in-mobile -y

Or target a specific client:

npx add-mcp claude-in-mobile -a claude-code -y
npx add-mcp claude-in-mobile -a opencode -y
npx add-mcp claude-in-mobile -a cursor -y

Claude Code CLI

claude mcp add --transport stdio mobile -- npx -y claude-in-mobile

To add globally (available in all projects):

claude mcp add --scope user --transport stdio mobile -- npx -y claude-in-mobile

OpenCode

Use the interactive setup:

opencode mcp add

Or add manually to opencode.json (project root or ~/.config/opencode/opencode.json):

{
  "mcp": {
    "mobile": {
      "type": "local",
      "command": ["npx", "-y", "claude-in-mobile"],
      "enabled": true
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "mobile": {
      "command": "npx",
      "args": ["-y", "claude-in-mobile"]
    }
  }
}

Any MCP Client

Print a config snippet for your client:

npx claude-in-mobile --init <client-name>
# Supported: opencode, cursor, claude-code

From npm

npx claude-in-mobile

From source

git clone https://github.com/AlexGladkov/claude-in-mobile.git
cd claude-in-mobile
npm install
npm run build:all  # Builds TypeScript + Desktop companion

Note: For Desktop support, you need to run npm run build:desktop (or build:all) to compile the Desktop companion app.

Using a local build with MCP clients

After building from source, point your MCP client to the local dist/index.js instead of using npx:

{
  "mcpServers": {
    "mobile": {
      "command": "node",
      "args": ["/path/to/claude-in-mobile/dist/index.js"]
    }
  }
}

For OpenCode (opencode.json):

{
  "mcp": {
    "mobile": {
      "type": "local",
      "command": ["node", "/path/to/claude-in-mobile/dist/index.js"],
      "enabled": true
    }
  }
}

Manual configuration

Add to your Claude Code settings (~/.claude.json or project settings):

{
  "mcpServers": {
    "mobile": {
      "command": "npx",
      "args": ["-y", "claude-in-mobile"]
    }
  }
}

Windows

claude mcp add --transport stdio mobile -- cmd /c npx -y claude-in-mobile

Requirements

Android

• ADB installed and in PATH
• Connected Android device (USB debugging enabled) or emulator

iOS

• macOS with Xcode installed
• iOS Simulator (no physical device support yet)
• WebDriverAgent for full UI inspection and element-based interaction:

  npm install -g appium
  appium driver install xcuitest
  

  Or set WDA_PATH environment variable to custom WebDriverAgent location

Desktop

• macOS (Windows/Linux support planned)
• JDK 17+ for building the Desktop companion
• Compose Multiplatform desktop application to test

Aurora OS

• audb CLI installed and in PATH (cargo install audb-client)
• Connected Aurora OS device with SSH enabled
• Python on device required for tap/swipe: devel-su pkcon install python

Available Tools

Core Tools (All Platforms)