Mobile

v0.0.7Browser Automationstable

A Model Context Protocol (MCP) server that provides mobile automation capabilities.

adbaiandroidclaudeios
Share:
65
Stars
0
Downloads
0
Weekly
0/5

What is Mobile?

Mobile is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server that provides mobile automation capabilities.

A Model Context Protocol (MCP) server that provides mobile automation capabilities.

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server that provides mobile a

Use Cases

Mobile device automation for AI agents
iOS and Android testing via MCP
runablehq

Maintainer

LicenseMIT
Languagetypescript
Versionv0.0.7
UpdatedMay 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y mobile-mcp

Manual Installation

npx -y mobile-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Mobile

Mobile MCP is a TypeScript MCP server that provides AI agents with programmatic mobile automation capabilities for Android devices — and soon iOS — without relying on screenshots or visual inputs. It works by exposing structured UI dumps, allowing AI assistants like Claude to navigate app screens, tap elements, enter text, and automate device interactions through Android Debug Bridge (ADB). This makes it practical for automated testing, app QA, and agent-driven mobile workflows directly from your AI chat interface.

Prerequisites

  • Node.js 18+ installed
  • Android Studio and Android platform-tools installed (for ADB)
  • ADB command available in PATH — verify with: adb version
  • An Android device or emulator with USB debugging enabled
  • An MCP-compatible client: Claude Desktop or VS Code with MCP extension
1

Install Android platform tools and verify ADB

ADB must be installed and accessible. Install Android Studio or the standalone platform-tools package, then verify the ADB binary is in your PATH.

# macOS via Homebrew
brew install android-platform-tools

# Verify
adb version
2

Connect your Android device

Enable USB debugging on your Android device (Settings → Developer Options → USB Debugging), connect via USB or set up a wireless ADB connection, and confirm the device is visible.

adb devices
# Should show your device listed as 'device' (not 'unauthorized')
3

Install mobile-mcp

Use the automatic installer to set up mobile-mcp and register it with Claude Desktop in one step, or install manually via npx.

# Automatic installer
npx mobile-mcp install

# Or run directly
npx -y mobile-mcp
4

Configure Claude Desktop manually (if needed)

If you did not use the automatic installer, add mobile-mcp to your claude_desktop_config.json manually.

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": ["mobile-mcp"]
    }
  }
}
5

Test mobile automation with Claude

Restart Claude Desktop and ask it to interact with your connected Android device. The server will use ADB to communicate with the device and return structured UI information.

Mobile Examples

Client configuration

claude_desktop_config.json entry for mobile-mcp. No environment variables are required — ADB handles device discovery automatically.

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

Prompts to try

Once connected with a device visible to ADB, use these prompts to drive mobile automation.

- "List the connected Android devices available via ADB."
- "Open the Settings app on my Android device."
- "Take a UI dump of the current screen and describe what elements are visible."
- "Navigate to the Wi-Fi settings page and list the available networks."
- "Automate filling out this login form on the connected device."

Troubleshooting Mobile

No devices found — adb devices returns empty or 'unauthorized'

Ensure USB debugging is enabled on your device. If the device shows as 'unauthorized', unlock your phone and accept the RSA key fingerprint prompt that appears. For wireless ADB, run 'adb connect <device-ip>:5555' first.

npx mobile-mcp fails to start or crashes

Run 'npx mobile-mcp' directly in your terminal to see the full error output. Common causes are Node.js version mismatches (require 18+) or ADB not found in PATH. Add the platform-tools directory to your PATH if adb is installed but not found.

UI automation commands do not affect the device screen

Confirm only one device is connected (adb devices should show exactly one entry). If multiple devices are connected, ADB commands may target the wrong one. Disconnect other devices or set ANDROID_SERIAL to the target device's serial number.

Frequently Asked Questions about Mobile

What is Mobile?

Mobile is a Model Context Protocol (MCP) server that model context protocol (mcp) server that provides mobile automation capabilities. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Mobile?

Install via npm with the command: npx -y mobile-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Mobile?

Mobile works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Mobile free to use?

Yes, Mobile is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Mobile?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides