android-remote-control

Android Remote Control MCP

An Android application that runs as an MCP (Model Context Protocol) server, enabling AI models to fully control an Android device remotely using accessibility services and screenshot capture.

The app runs directly on your Android device (or emulator) and exposes an HTTP server (with optional HTTPS) implementing the MCP protocol. AI models like Claude can connect to it and interact with any app on the device — reading UI elements, tapping buttons, typing text, swiping, capturing screenshots, managing files, launching apps, and more.

Warning: This software is provided "as-is" without warranty of any kind, for research and educational purposes only. The authors do not condone the use of this tool for any illegal, unauthorized, or unethical activities. Users are solely responsible for ensuring their use complies with all applicable laws and regulations. By using this software, you agree to use it responsibly and at your own risk.

---

Features

MCP Server

• HTTP server running directly on Android (Ktor + Netty), with optional HTTPS
• Streamable HTTP transport at /mcp (MCP specification compliant, JSON-only, no SSE)
• Bearer token authentication (global, all requests)
• Auto-generated self-signed TLS certificates (or custom certificate upload)
• Configurable binding: localhost (127.0.0.1) or network (0.0.0.0)
• Auto-start on boot
• Remote access tunnels via Cloudflare Quick Tunnels or ngrok (public HTTPS URL)

55 MCP Tools across 13 Categories

Screen introspection, system actions, touch actions, gestures, node actions, text input, utilities, file operations, app management, camera, intents, notifications, and location.

All tool names use the android_ prefix by default (e.g., android_tap). When a device slug is configured (e.g., pixel7), the prefix becomes android_pixel7_ (e.g., android_pixel7_tap).

See docs/MCP_TOOLS.md for the full tool reference with input/output schemas and examples.

Android App

• Material Design 3 UI with tabbed layout (Server / Settings / About) and dark mode
• Server status monitoring (running/stopped) with permission warning banner
• Connection info display (IP, port, token, tunnel URL)
• Per-tool and per-parameter permissions (enable/disable individual MCP tools)
• Permission management (Accessibility, Notifications, Camera, Microphone)
• Remote access tunnel configuration (Cloudflare / ngrok)
• Storage location management (automatic locations + SAF authorization for file tools)
• Server log viewer (MCP tool calls, tunnel events)
• Headless setup via ADB (configure, grant permissions, start/stop server without UI)

Comparison with Alternatives

Feature	This project	mobile-mcp	Android-MCP	android-mcp-server	adb-mcp	droidrun-mcp
MCP tools	55	21	11	5	10	11
Runs on the phone (no ADB)	:white_check_mark:	:x:	:x:	:x:	:x:	:x:
Action latency	10-100 ms	1-4 s	1-4 s	1-4 s	1-4 s	1-4 s
Works over the internet	:white_check_mark:	:x:	:x:	:x:	:x:	:x:
Token-efficient screen state	:white_check_mark:	:x:	:white_check_mark:	:x:	:x:	:white_check_mark:
Annotated screenshots	:white_check_mark:	:x:	:white_check_mark:	:x:	:x:	:x:
Configurable screenshot resolution/quality	:white_check_mark:	:x:	:x:	:x:	:x:	:x:
Per-tool enable/disable	:white_check_mark:	:x:	:x:	:x:	:x:	:x:
Multi-device support	:white_check_mark:	:white_check_mark:	:x:	:x:	:x:	:x:
Camera, clipboard, files, downloads	:white_check_mark:	:x:	:x:	:x:	:x:	:x:
iOS support	:x:	:white_check_mark:	:x:	:x:	:x:	:x:

Most alternatives rely on ADB running on a host machine, which means a USB cable or local network connection and a computer sitting next to the phone. This project runs entirely on the device itself, so you can expose the MCP endpoint through a tunnel and control your phone from anywhere.