Phone MCP

Phone MCP

Powerful MCP plugin to control an Android phone via ADB commands.

182
Stars
30
Forks
0
Releases

Overview

Phone MCP Plugin is a powerful MCP server that lets you control an Android device through ADB-based commands. It enables AI agents and automation scripts to perform a wide range of actions on a connected phone, including making calls, sending texts, managing contacts, launching apps, capturing screenshots, and controlling media. The plugin provides a unified screen-interaction and analysis interface, allowing agents to tap, swipe, type, and press keys, inspect UI elements, and wait for UI changes. It supports launching apps and activities via package names or intents, querying installed apps, and performing reliable navigation with full component names. It also offers UI monitoring and structured screen data to drive robust automation. Basic command sets are exposed through the included phone-cli tool, with extensive usage examples and configuration guidance to integrate into various AI assistant ecosystems.

Details

Owner
hao-cyber
Language
Python
License
Apache License 2.0
Updated
2025-12-07

Features

Call Functions

Make calls, end calls, and handle incoming calls.

Messaging

Send and receive SMS, access raw messages.

Contacts

Access contacts and create new contacts using automated UI interaction.

Media

Take screenshots, record screen, and control media playback.

Apps & Activities

Launch apps, launch specific activities with intents, list installed apps, and terminate apps.

UI Interaction

Tap, swipe, type text, and press keys on the device UI.

Screen Analysis

Structured screen information and unified interaction for informed automation decisions.

UI Monitoring

Monitor UI changes and wait for specific elements to appear or disappear.

Audience

AI assistantsEnable agents to control a connected Android device using MCP commands (calls, messaging, app launches) via configuration in their AI environment.
DevelopersIntegrate the MCP server into automation workflows using JSON-based configuration and the phone-mcp CLI to drive device automation.
Automation enthusiastsExperiment with screen analysis and UI monitoring to build robust automation scripts for Android devices.

Tags

AndroidADBUI AutomationPhone ControlAutomationAI AssistantsApp LaunchScreen AnalysisUI MonitoringContactsMessagingCalls