saranshbamania/mobile-device-mcp

MCP server that gives AI coding assistants (Claude Code, Cursor, Windsurf) the ability to **see and interact with mobile devices**. 49 tools for screenshots, UI inspection, touch interaction, AI-powered visual analysis, Flutter widget tree inspection, video recording, and test generation.
> AI assistants can read your code but can't see your phone. This fixes that.
Why This One?
| Feature | mobile-device-mcp | mobile-next/mobile-mcp | appium/appium-mcp |
|---------|:-:|:-:|:-:|
| Total tools | **49** | 20 | ~15 |
| Setup | npx (30 sec) | npx | Requires Appium server |
| AI visual analysis | **12 tools** (Claude + Gemini) | None | Vision-based finding |
| Flutter widget tree | **10 tools** (Dart VM Service) | None | None |
| Smart element finding | **4-tier** ( 28KB) | None | 50-80% |
| Multi-provider AI | Claude + Gemini | N/A | Single provider |
| Price | Free + Pro (₹499/mo) | Free | Free |
The Problem
Web developers have browser DevTools, Playwright, and Puppeteer -- AI assistants can click around, take screenshots, and verify fixes. Mobile developers? They're stuck manually screenshotting, copying logs, and describing what's on screen. They're **human middleware** between the AI and the device.
What This Does
Quick Start
Install
No global install needed. Runs directly via npx.
Prerequisites
- Node.js 18+
- Android device/emulator connected via ADB
- ADB installed (Android SDK Platform Tools)
Setup (One-time, 30 seconds)
1. **Get a Google AI key** (free tier available): aistudio.google.com/apikey
2. **Add .mcp.json to your project root:**
**macOS / Linux:**
**Windows:**
**With Pro license key** (after purchasing Pro):
macOS / Linux (Pro)
Windows (Pro)
3. **Open your AI coding assistant** from that directory. That's it.
The server starts and stops automatically -- you never run it manually. Your AI assistant manages it as a background process via the MCP protocol.
Verify It Works
**Claude Code:** type /mcp -- you should see mobile-device: Connected
**Cursor:** check MCP panel in settings
Then just talk to your phone:
No test scripts. No manual screenshots. Just describe what you want in plain English.
Works with Any AI Coding Assistant
| Tool | Config file | Docs |
|------|------------|------|
| **Claude Code** | .mcp.json in project root | claude.ai/docs |
| **Cursor** | .cursor/mcp.json | cursor.com/docs |
| **VS Code + Copilot** | MCP settings | code.visualstudio.com |
| **Windsurf** | MCP settings | windsurf.com |
All use the same JSON config -- just put it in the right file for your editor.
Drop Into Any Project
Copy .mcp.json into any mobile project -- Flutter, React Native, Kotlin, Swift -- and your AI assistant gets device superpowers in that directory. No global install needed.
Free vs Pro
Free (14 tools) -- no license key needed
| Tool | What it does |
|------|-------------|
| list_devices | List all connected Android devices/emulators |
| get_device_info | Model, manufacturer, Android version, SDK level |
| get_screen_size | Screen resolution in pixels |
| take_screenshot | Capture screenshot (PNG or JPEG, configurable quality & resize) |
| get_ui_elements | Get the accessibility/UI element tree as structured JSON |
| tap | Tap at coordinates |
| double_tap | Double tap at coordinates |
| long_press | Long press at coordinates |
| swipe | Swipe between two points |
| type_text | Type text into the focused field |
| press_key | Press a key (home, back, enter, volume, etc.) |
| list_apps | List installed apps |
| get_current_app | Get the foreground app |
| get_logs | Get logcat entries with filtering |
Pro (35 additional tools) -- ₹499/mo
**Get Pro License** -- unlock all 49 tools. After payment, you'll receive your license key via email within 1 hour. Add it to your .mcp.json: