phone-mcp

What it does

Phone-mcp bridges Claude and your Android device through ADB (Android Debug Bridge), exposing phone operations—calling, messaging, contacts, app control, UI automation, and screen analysis—as MCP tools. This lets Claude interact with your phone based on conversation context: for example, placing calls conditionally, sending messages, launching apps, or automating multi-step UI workflows like contact creation.

Who it's for

Mobile developers and power users who want Claude to automate Android tasks on their development or personal device—especially those testing app integrations, automating device UI workflows, or building conversational interfaces that need to control a real phone.

Common use cases

• Control app state: launch specific applications, send intents with parameters, or close apps based on conversation.
• Conditional communication: call a contact or send an SMS based on data or context Claude has analyzed.
• UI automation: navigate through phone menus, fill forms, or wait for UI changes to occur before proceeding.
• Device inspection: screenshot, capture screen recordings, or analyze the current UI structure for element location.
• Ambient control: use Claude as an intermediary for voice commands that affect your phone (music, settings, notifications).

Setup pitfalls

• ADB prerequisites: requires Android SDK tools installed locally, USB debugging enabled on the device, and a USB connection to the computer—misconfiguration silently fails with cryptic "device not found" errors.
• High privilege surface: writes to filesystem and direct device control mean this should only be used with trusted Android devices; the server runs with full phone access (calls, messages, location queries, app data).
• Stale codebase: last updated approximately 13 months ago; depends on ADB and Android SDK versions that may break silently with newer Android OS releases.
• Python path in configuration: the MCP config requires the full path to your Python interpreter; default paths like /usr/local/bin/python often do not exist (especially on macOS/ARM64) and must be verified with which python3.