Enables remote control of Android phones through ADB commands for making calls, sending texts, taking screenshots, manag...
Created byApr 22, 2025
Phone MCP Plugin
Downloads
A powerful MCP plugin that lets you control your Android phone with ease through ADB commands.
Example
Based on today's weather by browser, automatically select and play netease music, no confirmation needed
play_mucic_x2
Call Hao from the contacts. If he doesn't answer, send a text message telling him to come to Meeting Room 101.
call_sms_x2
Quick Start
Installation
Configuration
Cursor Setup
Configure in ~/.cursor/mcp.json:
Claude Setup
Add to Claude configuration:
Usage:
Use commands directly in Claude conversation, for example: Before using, ensure:
ADB is properly installed and configured
USB debugging is enabled on your Android device
Device is connected to computer via USB
Key Features
Call Functions: Make calls, end calls, receive incoming calls
Messaging: Send and receive SMS, get raw messages
Contacts: Access phone contacts, create new contacts with automated UI interaction
Media: Screenshots, screen recording, media control
Apps: Launch applications, launch specific activities with intents, list installed apps, terminate apps
System: Window info, app shortcuts
**Maps**: Search POIs with phone numbers
**UI Interaction**: Tap, swipe, type text, press keys
UI Inspection: Find elements by text, ID, class or description
UI Automation: Wait for elements, scroll to find elements
Screen Analysis: Structured screen information and unified interaction
Web Browser: Open URLs in device's default browser
UI Monitoring: Monitor UI changes and wait for specific elements to appear or disappear
Requirements
Python 3.7+
Android device with USB debugging enabled
ADB tools
Basic Commands
Device & Connection
Communication
Media & Apps
Screen Analysis & Interaction
Location & Maps
Advanced Usage
App and Activity Launch
The plugin provides multiple ways to launch apps and activities:
By App Name (Two Methods):
By Package Name (Two Methods):
By Package and Activity (Most Reliable Method):
Note: If you encounter issues with the app or open_app commands, always use the launch command with the full component name (package/activity) for the most reliable operation.
Contact Creation with UI Automation
The plugin provides a way to create contacts through UI interaction:
This command will:
Open the contacts app
Navigate to the contact creation interface
Fill in the name and phone number fields
Save the contact automatically
Screen-Based Automation
The unified screen interaction interface allows intelligent agents to easily:
Analyze screens: Get structured analysis of UI elements and text
Make decisions: Based on detected UI patterns and available actions
Execute interactions: Through a consistent parameter system
UI Monitoring and Automation
The plugin provides powerful UI monitoring capabilities to detect interface changes:
Basic UI monitoring:
Wait for specific elements to appear:
Monitor elements disappearing:
Get detailed UI change reports:
Tip: UI monitoring is especially useful for automation scripts to wait for loading screens to complete or confirm that actions have taken effect in the UI.
Detailed Documentation
For complete documentation and configuration details, visit our GitHub repository.
Tool Documentation
Screen Interface API
The plugin provides a powerful screen interface with comprehensive APIs for interacting with the device. Below are the key functions and their parameters:
interact_with_screen
Parameters:
Returns: JSON string with operation results
Examples:
analyze_screen
Parameters:
Returns: JSON string with detailed screen analysis
create_contact
Parameters:
Returns: JSON string with operation result
Location: This function is found in the 'contacts.py' module and implements UI automation to create contacts
launch_app_activity
Parameters:
Returns: JSON string with operation result
Location: This function is found in the 'apps.py' module
launch_intent
Parameters:
Returns: JSON string with operation result
Location: This function is found in the 'apps.py' module
License
Apache License, Version 2.0
Contact Creation Tool
This tool provides a simple way to create contacts on an Android device using ADB.
Prerequisites
Python 3.x
ADB (Android Debug Bridge) installed and configured
Android device connected and authorized for ADB
Usage
Basic Usage
Simply run the script:
This will create a contact with default values:
Account name: " "
Account type: "com.google"
Advanced Usage
You can provide custom account name and type using a JSON string:
Output
The script outputs a JSON object with:
success: boolean indicating if the operation was successful
message: any output or error message from the command
Example success output:
Error Handling
If ADB is not available or device is not connected, the script will return an error
Invalid JSON input will result in an error message
Any ADB command errors will be captured and returned in the message field
Notes
Make sure your Android device is connected and authorized for ADB use
The device screen should be unlocked when running the command
Some devices might require additional permissions to modify contacts
Apps & Shortcuts
Phone MCP Plugin
Downloads
A powerful MCP plugin that lets you control your Android phone with ease through ADB commands.
Example
Based on today's weather by browser, automatically select and play netease music, no confirmation needed
play_mucic_x2
Call Hao from the contacts. If he doesn't answer, send a text message telling him to come to Meeting Room 101.
call_sms_x2
Quick Start
Installation
Configuration
Cursor Setup
Configure in ~/.cursor/mcp.json:
Claude Setup
Add to Claude configuration:
Usage:
Use commands directly in Claude conversation, for example: Before using, ensure:
ADB is properly installed and configured
USB debugging is enabled on your Android device
Device is connected to computer via USB
Key Features
Call Functions: Make calls, end calls, receive incoming calls
Messaging: Send and receive SMS, get raw messages
Contacts: Access phone contacts, create new contacts with automated UI interaction
Media: Screenshots, screen recording, media control
Apps: Launch applications, launch specific activities with intents, list installed apps, terminate apps
System: Window info, app shortcuts
**Maps**: Search POIs with phone numbers
**UI Interaction**: Tap, swipe, type text, press keys
UI Inspection: Find elements by text, ID, class or description
UI Automation: Wait for elements, scroll to find elements
Screen Analysis: Structured screen information and unified interaction
Web Browser: Open URLs in device's default browser
UI Monitoring: Monitor UI changes and wait for specific elements to appear or disappear
Requirements
Python 3.7+
Android device with USB debugging enabled
ADB tools
Basic Commands
Device & Connection
Communication
Media & Apps
Screen Analysis & Interaction
Location & Maps
Advanced Usage
App and Activity Launch
The plugin provides multiple ways to launch apps and activities:
By App Name (Two Methods):
By Package Name (Two Methods):
By Package and Activity (Most Reliable Method):
Note: If you encounter issues with the app or open_app commands, always use the launch command with the full component name (package/activity) for the most reliable operation.
Contact Creation with UI Automation
The plugin provides a way to create contacts through UI interaction:
This command will:
Open the contacts app
Navigate to the contact creation interface
Fill in the name and phone number fields
Save the contact automatically
Screen-Based Automation
The unified screen interaction interface allows intelligent agents to easily:
Analyze screens: Get structured analysis of UI elements and text
Make decisions: Based on detected UI patterns and available actions
Execute interactions: Through a consistent parameter system
UI Monitoring and Automation
The plugin provides powerful UI monitoring capabilities to detect interface changes:
Basic UI monitoring:
Wait for specific elements to appear:
Monitor elements disappearing:
Get detailed UI change reports:
Tip: UI monitoring is especially useful for automation scripts to wait for loading screens to complete or confirm that actions have taken effect in the UI.
Detailed Documentation
For complete documentation and configuration details, visit our GitHub repository.
Tool Documentation
Screen Interface API
The plugin provides a powerful screen interface with comprehensive APIs for interacting with the device. Below are the key functions and their parameters:
interact_with_screen
Parameters:
Returns: JSON string with operation results
Examples:
analyze_screen
Parameters:
Returns: JSON string with detailed screen analysis
create_contact
Parameters:
Returns: JSON string with operation result
Location: This function is found in the 'contacts.py' module and implements UI automation to create contacts
launch_app_activity
Parameters:
Returns: JSON string with operation result
Location: This function is found in the 'apps.py' module
launch_intent
Parameters:
Returns: JSON string with operation result
Location: This function is found in the 'apps.py' module
License
Apache License, Version 2.0
Contact Creation Tool
This tool provides a simple way to create contacts on an Android device using ADB.
Prerequisites
Python 3.x
ADB (Android Debug Bridge) installed and configured
Android device connected and authorized for ADB
Usage
Basic Usage
Simply run the script:
This will create a contact with default values:
Account name: " "
Account type: "com.google"
Advanced Usage
You can provide custom account name and type using a JSON string:
Output
The script outputs a JSON object with:
success: boolean indicating if the operation was successful
message: any output or error message from the command
Example success output:
Error Handling
If ADB is not available or device is not connected, the script will return an error
Invalid JSON input will result in an error message
Any ADB command errors will be captured and returned in the message field
Notes
Make sure your Android device is connected and authorized for ADB use
The device screen should be unlocked when running the command
Some devices might require additional permissions to modify contacts