https://github.com/runablehq/mobile-mcp
A Model Context Protocol (MCP) server that provides mobile automation capabilities.
https://github.com/runablehq/mobile-mcp
adb ai android claude ios llm mcp model-context-protocol nodejs typescript
Last synced: 4 months ago
JSON representation
A Model Context Protocol (MCP) server that provides mobile automation capabilities.
- Host: GitHub
- URL: https://github.com/runablehq/mobile-mcp
- Owner: runablehq
- License: mit
- Created: 2025-04-01T06:44:17.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-02T12:11:27.000Z (7 months ago)
- Last Synced: 2025-07-05T14:58:57.037Z (4 months ago)
- Topics: adb, ai, android, claude, ios, llm, mcp, model-context-protocol, nodejs, typescript
- Language: TypeScript
- Homepage:
- Size: 150 KB
- Stars: 48
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-mcp-servers - **mobile-mcp** - A Model Context Protocol (MCP) server that provides mobile automation capabilities. `typescript` `adb` `ai` `android` `claude` `npm install runablehq/mobile-mcp` (🤖 AI/ML)
- awesome-mcp-servers - **mobile-mcp** - A Model Context Protocol (MCP) server that provides mobile automation capabilities. `typescript` `adb` `ai` `android` `claude` `npm install runablehq/mobile-mcp` (AI/ML)
README
# 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.
[](LICENSE) [](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).