PhonePi MCP

PhonePi MCP

A MCP server that lets you control your phone from your favorite AI apps!

Prerequisites

You need to setup the PhonePi MCP app on your phone. Please visit PhonePi MCP for instructions.

Installation

Install the package globally:

npm install -g phonepi-mcp

Or run directly with npx:

npx phonepi-mcp

Setup

Simply add the following MCP config to your AI app:

{
  "mcpServers": {
    "phonepi-mcp": {
      "command": "npx",
      "args": [
        "phonepi-mcp",
        "start"
      ]
    }
  }
}

Standalone usage

The setup instructions above is all you need for setting it up with respect to MCP.

But, PhonePi MCP also provides a standalone command-line interface to control the MCP server.

Commands

• start: Start the MCP server
• stop: Stop the running MCP server
• status: Check if the MCP server is running
• restart: Restart the MCP server

Starting the Server

phonepi-mcp start

Options:

• -p, --port <port>: Specify the port to run the server on (default: 11041)
• -b, --background: Run the server in the background

Example:

phonepi-mcp start -p 8080 -b

Checking Server Status

phonepi-mcp status

Stopping the Server

phonepi-mcp stop

Restarting the Server

phonepi-mcp restart

Options:

• -p, --port <port>: Specify the port to run the server on (default: 11041)
• -b, --background: Run the server in the background

Connecting 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:

npm run build

Run in development mode:

npm run dev

License

MIT