Bridge AI to Your Phone using MCP!

Create a mcp.json file (or similar - basis the app you are enabling this MCP server for) with this configuration:

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

This configuration enables the MCP server in your AI app.

Here are some example queries you can try with your AI assistant:

• • "Create a landing page for my project and notify me on my phone when it's done"
• • "Search my phone contacts for John and send him a message"
• • "Create a note on my phone with today's meeting minutes"
• • "Help me find my phone by making it beep"

Try the PhonePi CLI for command-line access to your phone's features

Our CLI provides an AI-powered interface to control your phone directly from your terminal, no installation required:

npx phonepi-cli chat --key your-anthropic-api-key

You can also run a single query without entering interactive mode:

npx phonepi-cli query "What's my battery level?" --key your-anthropic-api-key

The CLI handles starting the MCP server automatically, making it a convenient option for quick interactions with your phone.

If you're experiencing connection issues, try these troubleshooting steps:

• • Ensure your phone and computer (running your AI app like Cursor) are on the same network
• • Verify you're using the correct IP address:
  • - For macOS/Linux: Open Terminal and run ifconfig or ip addr
  • - For Windows: Open Command Prompt and run ipconfig
• • Verify the correct port is being used (default is 11041)
• • Note: Only one AI app can use the specific port (11041) at a time
• • If devices are on different networks, consider using Tailscale to create a secure network between them
• • If the server won't start because port 11041 is in use, you can kill the process:
  • - For macOS/Linux:

    lsof -i :11041

    Then use the PID to kill the process:

    kill -9 [PID]

  • - For Windows:

    netstat -ano | findstr :11041

    Then use the PID to kill the process:

    taskkill /F /PID [PID]

• • Restart the MCP server with this command:

npx phonepi-mcp stop

After stopping any existing instances, restart the MCP server from your AI app (like Cursor).