# Mobile MCP

A Model Context Protocol (MCP) server that provides mobile automation capabilities. This server enables LLMs to interact with mobile devices using structured UI dumps without needing to rely on screenshots or other visual inputs.

[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![Discord](https://img.shields.io/badge/discord-purple.svg)](https://discord.runable.xyz)

https://github.com/user-attachments/assets/f6d9c88e-005a-4a99-b073-3308b1fbca12

## Installation 

## Supported Platforms

Currently, only android phones are supported. iOS support will come soon.

You need to [install android studio](https://developer.android.com/studio/install) and have platform tools installed. Run the following to command to verify once you have installed all this.

```sh
adb
```

You can run an [android device in an emulator](https://developer.android.com/studio/run/emulator) or connect your physical android phone with usb debugging on.

### Claude Desktop Configuration
Run the following command to install it automatically

```sh
npx mobile-mcp install
```

or add this to your claude desktop config manually.

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

## VScode Installation

You can install the mobile MCP server using the VS Code CLI:

```bash
# For VS Code
code --add-mcp '{"name":"mobile","command":"npx","args":["mobile-mcp"]}'

# For VS Code Insiders
code-insiders --add-mcp '{"name":"mobile","command":"npx","args":["mobile-mcp"]}'
```

## 📄 License

This project is licensed under the [MIT License](LICENSE).