phone-mcp

Overview

Phone MCP is a comprehensive Python-based MCP server that enables AI assistants to control Android devices through ADB commands. It provides extensive functionality including phone calls, SMS messaging, contact management, app control, media operations, and sophisticated UI automation with screen analysis. The server features a unified interaction interface that allows complex automated workflows, such as playing music based on weather or creating multi-step communications protocols.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• interact_with_screenasync def interact_with_screen(action: str, params: Dict[str, Any] = None) -> str

  Execute screen interaction actions like tap, swipe, key press, text input, and element finding

  Try:Tap on the login buttonTry:Swipe down on the screenTry:Find element by text 'Settings'
• analyze_screenasync def analyze_screen(include_screenshot: bool = False, max_elements: int = 50) -> str

  Analyze the current screen and provide structured information about UI elements

  Try:Analyze the current screenTry:Describe what's on the screen with a screenshot
• create_contactasync def create_contact(name: str, phone: str) -> str

  Create a new contact with the given name and phone number using UI automation

  Try:Create a new contact named John with phone 1234567890Try:Add Jane Doe to contacts with number 987654321
• launch_app_activityasync def launch_app_activity(package_name: str, activity_name: Optional[str] = None) -> str

  Launch an app using package name and optionally an activity name

  Try:Launch the camera appTry:Open com.android.settings/.Settings
• launch_intentasync def launch_intent(intent_action: str, intent_type: Optional[str] = None, extras: Optional[Dict[str, str]] = None) -> str

  Launch an activity using Android intent system

  Try:Launch a phone call to 1234567890Try:Open a web page
• make_call

  Make a phone call to a specified number

  Try:Call John at 1234567890Try:Make a call to 5551234567
• send_sms

  Send a text message to a specified number

  Try:Send SMS to Jane: 'Meeting at 3pm'Try:Text John 'Where are you?'
• get_messages

  Get received or sent messages with pagination

  Try:Show me my recent messagesTry:Get last 10 text messages
• get_contacts

  Get phone contacts with pagination

  Try:List all my contactsTry:Show me contacts starting with J
• screenshot

  Take a screenshot of the phone screen

  Try:Take a screenshotTry:Capture the current screen
• monitor_ui

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

  Try:Wait for the login button to appearTry:Monitor screen until the loading message disappears
• get_poi

  Search nearby points of interest with phone numbers

  Try:Find restaurants near me with phone numbersTry:Search for coffee shops within 1km

Comparable tools

Installation

# Run directly with uvx (recommended)
uvx phone-mcp

# Or install with uv
uv pip install phone-mcp

# Or install with pip
pip install phone-mcp

{
    "mcpServers": {
        "phone-mcp": {
            "command": "uvx",
            "args": [
                "phone-mcp"
            ]
        }
    }
}

{
    "mcpServers": {
        "phone-mcp": {
            "command": "/usr/local/bin/python",
            "args": [
                "-m",
                "phone_mcp"
            ]
        }
    }
}

FAQ

What are the requirements to use phone-mcp?

You need Python 3.7+, ADB tools installed, and an Android device with USB debugging enabled.

How do I configure my AI assistant to use phone-mcp?

Add the server configuration to your AI assistant's MCP settings using either uvx or python with the appropriate command and arguments.

Can I automate app launches and UI interactions?

Yes, the server provides a unified screen interaction interface that can tap, swipe, input text, find elements, and wait for UI changes.

Compare phone-mcp with