phone control (android adb).com
phone control (android adb).com logo

Phone Control (Android ADB)

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:
  1. By App Name (Two Methods):
  1. By Package Name (Two Methods):
  1. 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:
  1. Open the contacts app
  1. Navigate to the contact creation interface
  1. Fill in the name and phone number fields
  1. Save the contact automatically

Screen-Based Automation

The unified screen interaction interface allows intelligent agents to easily:
  1. Analyze screens: Get structured analysis of UI elements and text
  1. Make decisions: Based on detected UI patterns and available actions
  1. Execute interactions: Through a consistent parameter system

UI Monitoring and Automation

The plugin provides powerful UI monitoring capabilities to detect interface changes:
  1. Basic UI monitoring:
  1. Wait for specific elements to appear:
  1. Monitor elements disappearing:
  1. 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:
  1. By App Name (Two Methods):
  1. By Package Name (Two Methods):
  1. 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:
  1. Open the contacts app
  1. Navigate to the contact creation interface
  1. Fill in the name and phone number fields
  1. Save the contact automatically

Screen-Based Automation

The unified screen interaction interface allows intelligent agents to easily:
  1. Analyze screens: Get structured analysis of UI elements and text
  1. Make decisions: Based on detected UI patterns and available actions
  1. Execute interactions: Through a consistent parameter system

UI Monitoring and Automation

The plugin provides powerful UI monitoring capabilities to detect interface changes:
  1. Basic UI monitoring:
  1. Wait for specific elements to appear:
  1. Monitor elements disappearing:
  1. 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