pip install phone-mcp # or use uvx uvx phone-mcp

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

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

# Check device connection phone-cli check # Get screen size phone-cli screen-interact find method=clickable

# Make a call phone-cli call 1234567890 # End current call phone-cli hangup # Send SMS phone-cli send-sms 1234567890 "Hello" # Check messages phone-cli messages --limit 10 # Get contacts phone-cli contacts --limit 20

# Take screenshot phone-cli screenshot # Record screen phone-cli record --duration 30 # Launch app phone-cli app camera # Close app phone-cli close-app com.android.camera # List installed apps phone-cli list-apps --filter camera --third-party # Launch specific activity phone-cli launch com.android.settings/.Settings # Open URL in default browser phone-cli open-url google.com

# Analyze current screen with structured information phone-cli analyze-screen # Unified interaction interface phone-cli screen-interact <action> [parameters] # Tap on element by text phone-cli screen-interact tap element_text="Login" # Tap at coordinates phone-cli screen-interact tap x=500 y=800 # Swipe gesture (scroll down) phone-cli screen-interact swipe x1=500 y1=1000 x2=500 y2=200 duration=300 # Press key phone-cli screen-interact key keycode=back # Input text phone-cli screen-interact text content="Hello World" # Find elements phone-cli screen-interact find method=text value="Login" partial=true # Wait for element phone-cli screen-interact wait method=text value="Success" timeout=10 # Scroll to find element phone-cli screen-interact scroll method=text value="Settings" direction=down max_swipes=5 # Monitor UI changes phone-cli monitor-ui --interval 1 --duration 60

# Search nearby POIs with phone numbers phone-cli get-poi 116.480053,39.987005 --keywords restaurant --radius 1000