PhonePi MCP - CLI tool for phone control via WebSocket
npm install phonepi-mcpA MCP server that lets you control your phone from your favorite AI apps!
Install the package globally:
``bash`
npm install -g phonepi-mcp
Or run directly with npx:
`bash`
npx phonepi-mcp
{
"mcpServers": {
"phonepi-mcp": {
"command": "npx",
"args": [
"phonepi-mcp",
"start"
]
}
}
}
`Save the file with the above settings. This is all you need for your setup besides the mobile app.
Connecting
* Ensure your phone and your desktop are on the same network. Using something like Tailscale is recommended for convenience, but it's optional.
* Enter the local ip address and port (11041) in the companion mobile app to connect to the server.
* Once everything's connected correctly, you can simply start asking your AI assistant to do stuff! For example, try asking it to send a test notification to your phone.MCP server management cli (Optional)
Standalone usage
The setup instructions above is all you need for setting it up with respect to MCP clients like Cline, Claude Desktop etc.But, PhonePi MCP also provides a standalone command-line interface for you to manage the MCP server from outside the clients.
$3
-
start: Start the MCP server
- stop: Stop the running MCP server
- status: Check if the MCP server is running
- restart: Restart the MCP server$3
`bash
phonepi-mcp start
`Options:
-
-p, --port : Specify the port to run the server on (default: 11041)
- -b, --background: Run the server in the backgroundExample:
`bash
phonepi-mcp start -p 8080 -b
`$3
`bash
phonepi-mcp status
`$3
`bash
phonepi-mcp stop
`$3
`bash
phonepi-mcp restart
`Options:
-
-p, --port : Specify the port to run the server on (default: 11041)
- -b, --background: Run the server in the backgroundConnecting Your Phone
1. Install the PhonePi MCP app on your phone
2. Start the server on your computer using
phonepi-mcp start
3. In the app, connect to your computer's IP address and port (default 11041)Features
- Remote phone control via MCP protocol
- Get battery level
- Send SMS messages
- Make phone calls
- Find your phone by making it beep
- Set timers and alarms
- Copy text to clipboard
- Manage contacts
- Send notifications
Development
Build the package:
`bash
npm run build
`Run in development mode:
`bash
npm run dev
``MIT