home / mcp / claude mobile mcp server

Claude Mobile MCP Server

Provides a unified MCP interface to automate Android and iOS simulators with commands like tap, screenshot, input text, and manage apps.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Claude Mobile MCP Server lets you control Android devices and iOS simulators using natural language. It provides a unified command surface for both platforms, enabling actions like tapping, typing, launching apps, taking smart screenshots, and reading logs straight from your devices through Claude.

How to use

To interact with your mobile devices through Claude, set up the Mobile MCP server in your Claude Code environment and connect a client that can send MCP requests. You can direct Claude to perform actions on either Android or iOS, or let the server auto-detect the active platform. Use natural language prompts like: show connected devices, take a screenshot, tap on Settings, type text, open Safari, or run an app on both platforms. You can explicitly specify the platform when needed or switch between devices as you work.

How to install

Prerequisites you need before installing the Mobile MCP Server: Node.js and npm (Node package manager) installed on your system.

Install and register the MCP server using one of the provided methods. Pick the method that matches your workflow.

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

To install globally so the server is available in all your Claude projects, run this variant.

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

Additional installation options

If you prefer running directly from npm without the MCP register step, you can start the mobile integration with this command.

npx claude-in-mobile

If you are setting up a manual configuration in your Claude Code settings, paste the following JSON snippet to wire the Mobile MCP Server.

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

Windows specific setup

On Windows, you can configure the mobile MCP server to run via the Windows command shell using this form.

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

Available tools

list_devices

List all connected devices for Android and iOS to identify targets.

set_device

Select the active device for subsequent commands.

screenshot

Capture a screenshot from the active device or emulator.

tap

Tap at specific coordinates or on UI elements identified by text.

long_press

Perform a long press gesture on a target location or element.

swipe

Swipe in a direction or across coordinates to scroll or navigate.

input_text

Type text into the currently focused input field.

press_key

Simulate hardware button presses on the device.

launch_app

Launch an installed application on the active device.

stop_app

Terminate a running application on the device.

install_app

Install an APK (Android) or app package (iOS) on the device.

get_ui

Retrieve the UI hierarchy from the device to aid element discovery.

find_element

Find UI elements by text or identifier for interactions.

get_current_activity

Query the current foreground activity on Android.

open_url

Open a URL in the device's browser.

shell

Execute a shell command on the device or simulator.

wait

Wait for a specified duration before proceeding.

get_logs

Fetch device logs, including logcat and system logs.

clear_logs

Clear the device's log buffers.

get_system_info

Return system-level information like battery and memory.