Claude Mobile

MCP server for mobile device automation — Android (via ADB) and iOS Simulator (via simctl). Like Claude in Chrome but for mobile devices.

Control your Android phone, emulator, or iOS Simulator with natural language through Claude.

Features

• Unified API — Same commands work for both Android and iOS
• Smart screenshots — Auto-compressed for optimal LLM processing (no more oversized images!)
• 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 or iOS, or auto-detect

Installation

Claude Code CLI (recommended)

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

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

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

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)

Available Tools

Tool	Android	iOS	Description
list_devices	✅	✅	List all connected devices
set_device	✅	✅	Select active device
screenshot	✅	✅	Take screenshot
tap	✅	✅	Tap at coordinates or by text
long_press	✅	✅	Long press gesture
swipe	✅	✅	Swipe in direction or coordinates
input_text	✅	✅	Type text
press_key	✅	✅	Press hardware buttons
launch_app	✅	✅	Launch app
stop_app	✅	✅	Stop app
install_app	✅	✅	Install APK/.app
get_ui	✅	⚠️	Get UI hierarchy (limited on iOS)
find_element	✅	❌	Find elements by text/id
get_current_activity	✅	❌	Get foreground activity
open_url	✅	✅	Open URL in browser
shell	✅	✅	Run shell command
wait	✅	✅	Wait for duration
get_logs	✅	✅	Get device logs (logcat/system log)
clear_logs	✅	⚠️	Clear log buffer
get_system_info	✅	❌	Battery, memory info

Usage Examples

Just talk to Claude naturally:

"Show me all connected devices"
"Take a screenshot of the Android emulator"
"Take a screenshot on iOS"
"Tap on Settings"
"Swipe down to scroll"
"Type 'hello world' in the search field"
"Press the back button on Android"
"Open Safari on iOS"
"Switch to iOS simulator"
"Run the app on both platforms"

Platform Selection

You can explicitly specify the platform:

"Screenshot on android"     → Uses Android device
"Screenshot on ios"         → Uses iOS simulator
"Screenshot"                → Uses last active device

Or set the active device:

"Use the iPhone 15 simulator"
"Switch to the Android emulator"

How It Works

┌─────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   Claude    │────▶│  Claude Mobile   │────▶│  Android (ADB)  │
│             │     │   MCP Server     │     └─────────────────┘
│             │     │                  │     ┌─────────────────┐
│             │     │                  │────▶│  iOS (simctl)   │
└─────────────┘     └──────────────────┘     └─────────────────┘

1. Claude sends commands through MCP protocol
2. Server routes to appropriate platform (ADB or simctl)
3. Commands execute on your device
4. Results (screenshots, UI data) return to Claude

License

MIT