Claude Mobile Dev MCP

An MCP (Model Context Protocol) server that gives Claude real-time access to mobile development tools. Stop copy-pasting logs and screenshots - let Claude see your app directly!

Open Core: 17 core tools are MIT licensed (free forever). 39 advanced tools are source-available under Elastic License 2.0.

Features

• Metro Log Streaming - Claude can read Metro bundler output in real-time
• ADB Logcat Integration - Get React Native logs directly from your device/emulator
• iOS Simulator Support - Screenshots and logs from iOS Simulators (macOS only)
• Screenshot Capture - Claude can see your app's current screen (Android & iOS)
• Device Management - List devices, check status, restart ADB
• App Management - Get app info, clear data for fresh testing
• React DevTools Integration - Inspect React component trees, props, and state
• Expo DevTools Integration - Check Expo server status, manage config, trigger reloads, EAS builds
• Performance Metrics - CPU, memory, FPS, and battery monitoring for your app

Pricing

| Tier | Price | Features | |------|-------|----------| | TRIAL | Free (50 requests) | Try all 56 tools, then purchase to continue | | BASIC | $6/month | 17 core tools (Android + iOS basics), 50 log lines max, 1 device | | ADVANCED | $8/week, $12/month, or $99/year | All 56 tools, unlimited logs, 3 devices, streaming, DevTools, network, Expo, performance |

Purchase at: https://mobile-dev-mcp.com

Installation

Option 1: NPX (Recommended)

# Add to Claude Code
claude mcp add mobile-dev -- npx @ggboi360/mobile-dev-mcp

Or add to your ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mobile-dev": {
      "command": "npx",
      "args": ["@ggboi360/mobile-dev-mcp"]
    }
  }
}

Option 2: Manual Setup (Development)

# Clone the repo
git clone https://github.com/GGBoi360/mobile-dev-mcp.git
cd mobile-dev-mcp

# Install dependencies
npm install

# Build
npm run build

# Add to Claude Code
claude mcp add mobile-dev -- node /path/to/mobile-dev-mcp/dist/index.js

Requirements

• Node.js >= 18.0.0
• For Android:
  • ADB (Android Debug Bridge) - Part of Android SDK Platform Tools
  • Download Platform Tools
  • Make sure adb is in your PATH
• For iOS (macOS only):
  • Xcode with Command Line Tools
  • Run xcode-select --install if not installed

Available Tools

Core Tools - Android (All Tiers)

| Tool | Description | |------|-------------| | get_metro_logs | Get recent Metro bundler logs with optional filtering | | get_adb_logs | Get React Native logs from device via ADB logcat | | screenshot_emulator | Capture screenshot from Android emulator | | list_devices | List connected Android devices/emulators | | check_metro_status | Check if Metro bundler is running | | get_app_info | Get info about an installed app | | clear_app_data | Clear app data for fresh testing | | restart_adb | Restart ADB server when it gets stuck | | get_device_info | Get detailed device information | | start_metro_logging | Start capturing Metro logs in background | | stop_metro_logging | Stop Metro log capture |

Core Tools - iOS Simulator (All Tiers, macOS only)

| Tool | Description | |------|-------------| | list_ios_simulators | List all available iOS Simulators | | screenshot_ios_simulator | Capture screenshot from iOS Simulator | | get_ios_simulator_logs | Get logs from iOS Simulator | | get_ios_simulator_info | Get detailed simulator information |

License Tools (All Tiers)

| Tool | Description | |------|-------------| | get_license_status | Check your current license tier and limits | | set_license_key | Activate a license key to unlock paid features |

Advanced Tools - Android (Advanced Tier Only)

| Tool | Description | |------|-------------| | stream_adb_realtime | Start real-time ADB log streaming in background | | stop_adb_streaming | Stop real-time ADB log streaming | | screenshot_history | Get previously captured screenshots (stores up to 20) | | watch_for_errors | Monitor logs for specific error patterns | | multi_device_logs | Get logs from multiple devices simultaneously | | tap_screen | Tap on the screen at specific coordinates | | input_text | Type text into the currently focused input field | | press_button | Press hardware buttons (back, home, recent, volume, power) | | swipe_screen | Swipe/scroll on the screen | | launch_app | Launch an app by package name | | install_apk | Install an APK file to the device |

Advanced Tools - iOS Simulator (Advanced Tier Only, macOS)

| Tool | Description | |------|-------------| | boot_ios_simulator | Boot an iOS Simulator by UDID or name | | shutdown_ios_simulator | Shutdown an iOS Simulator (or all) | | install_ios_app | Install an app (.app bundle) on simulator | | launch_ios_app | Launch an app by bundle identifier | | terminate_ios_app | Force quit an app on simulator | | ios_open_url | Open a URL (deep links, universal links) | | ios_push_notification | Send a push notification to simulator | | ios_set_location | Set simulated GPS location |

Advanced Tools - React DevTools (Advanced Tier Only)

| Tool | Description | |------|-------------| | setup_react_devtools | Configure React DevTools connection and port forwarding | | check_devtools_connection | Check if DevTools is connected to your app | | get_react_component_tree | Get the React component hierarchy | | inspect_react_component | Inspect a component's props, state, and hooks | | search_react_components | Search for components by name |

Advanced Tools - Network Inspection (Advanced Tier Only)

| Tool | Description | |------|-------------| | get_network_requests | Get recent HTTP/HTTPS requests from app logs | | start_network_monitoring | Start real-time network request capture | | stop_network_monitoring | Stop monitoring and get summary | | get_network_stats | Get device network statistics (WiFi, data usage) | | analyze_request | Analyze a specific captured request in detail |

Advanced Tools - Expo DevTools (Advanced Tier Only)

| Tool | Description | |------|-------------| | check_expo_status | Check Expo dev server status and connected devices | | get_expo_config | Get Expo project configuration (app.json/app.config.js) | | expo_dev_menu | Open the Expo developer menu on device | | expo_reload | Trigger a reload of the Expo app | | get_eas_builds | Get recent EAS build status and download links |

Advanced Tools - Performance Metrics (Advanced Tier Only)

| Tool | Description | |------|-------------| | get_cpu_usage | Get CPU usage for device or specific app | | get_memory_usage | Get memory usage (heap, native, PSS) for an app | | get_fps_stats | Get frame rendering stats (jank frames, percentiles) | | get_battery_stats | Get battery consumption by app | | get_performance_snapshot | Get all metrics at once for quick profiling |

Usage Examples

Once installed, Claude can use these tools automatically:

You: "Check if my Metro bundler is running" Claude: Uses check_metro_status tool "Metro is running on port 8081..."

You: "Show me the recent React Native errors" Claude: Uses get_adb_logs with filter='E' "I found 3 errors in the logs..."

You: "Take a screenshot of my app" Claude: Uses screenshot_emulator "Here's what your app looks like..." [shows image]

You: "What's happening with my app? It crashed" Claude: Uses get_adb_logs and screenshot_emulator "I can see a null pointer exception in the logs, and the screen shows..."

You: "Show me the React component tree" Claude: Uses get_react_component_tree "Here's your component hierarchy: App > Navigator > HomeScreen > ..."

You: "Inspect the UserProfile component" Claude: Uses search_react_components and inspect_react_component "Found UserProfile with props: {userId: '123'}, state: {loading: false, data: {...}}"

You: "What API calls is my app making?" Claude: Uses get_network_requests "Found 15 requests: GET /api/users (200), POST /api/login (200), GET /api/feed (500 error)..."

You: "Monitor network traffic while I use the app" Claude: Uses start_network_monitoring "Network monitoring started. Make some requests, then I'll summarize them."

You: "Is my Expo server running?" Claude: Uses check_expo_status "Expo is running on port 8081. Metro bundler active, 1 device connected."

You: "Reload the app" Claude: Uses expo_reload "App reloaded! The JavaScript bundle has been refreshed."

You: "Show me my EAS builds" Claude: Uses get_eas_builds "Found 3 recent builds: Android production (complete), iOS staging (in progress)..."

You: "Is my app using too much memory?" Claude: Uses get_memory_usage "Your app is using 145 MB (PSS). Java heap: 45 MB, Native: 78 MB. This is within normal range."

You: "Check the performance of com.myapp" Claude: Uses get_performance_snapshot "CPU: 12%, Memory: 145 MB, Frames: 2450 rendered, 3% janky. Battery: 85%, temp 32°C"

You: "Why is my app laggy?" Claude: Uses get_fps_stats "Found 15% janky frames. 90th percentile frame time is 24ms (should be <16ms). Consider optimizing heavy UI operations."

Workflow

1. Start your Metro bundler: npx expo start or npx react-native start
2. Start your emulator (Genymotion, Android Studio, etc.)
3. Start Claude Code with this MCP server installed
4. Ask Claude about your app - it can now see logs and screenshots!

Roadmap

• [x] Real-time log streaming (Advanced tier)
• [x] Screenshot history (Advanced tier)
• [x] Multi-device support (Advanced tier)
• [x] Error pattern watching (Advanced tier)
• [x] iOS Simulator support (screenshots, logs, app management)
• [x] React DevTools integration (component tree, props, state inspection)
• [x] Network request inspection (capture, monitor, analyze HTTP traffic)
• [x] Expo DevTools integration (server status, config, reload, EAS builds)
• [x] Performance metrics (CPU, memory, FPS, battery monitoring)
• [ ] Team tier with centralized license management

License Activation

1. Purchase a license at https://mobile-dev-mcp.com
2. You'll receive a license key via email
3. Use the set_license_key tool to activate: set_license_key with your key
4. Or add to config file: ~/.mobiledev-mcp/config.json

Contributing

PRs welcome! Help us make mobile dev with Claude actually usable.

Built with frustration and determination by the mobile dev community.