PhonePi MCP: Turn your phone into a toolbox for AI assistants using Model Context Protocol

A powerful MCP server and companion app that allows you to manage and control your phone remotely using natural language commands via your favorite MCP-supported AI apps such as Cursor and Claude Desktop. This project provides a comprehensive set of tools and APIs to interact with your mobile device programmatically.

Overview

Phone MCP enables you to:

• Manage contacts and messages
• Handle snippets and notes
• Control phone settings and notifications
• Prepare SMS messages for confirmation on your phone and make calls
• Share content across apps
• Monitor battery status
• Set timers and reminders
• Find your phone with audio alerts

Security

Security is a high concern. Here are a few aspects taken into account around security:

• You are completely in charge around hosting the MCP server locally. The code is completely open source.
• On the app front, you are in charge of what permissions to give depending on the features you want to use.
• The app and the server are linked over your local network. There's no 3p remote servers involved in linking.
• It is highly recommended you use this app over a secure network. Avoid public networks like airports and restaurants.
• Tailscale is highly recommended for creating a private & secure VPN to connect your phone and desktops

Getting Started

For detailed documentation, features, and setup instructions, please visit:
phonepimcp.com

Support & Issues

If you encounter any bugs or have feature requests, please open an issue on our GitHub repository.

Background connections (Android app 1.0.1 and later)

Connect to your desktop server, then enable Background Service while PhonePi MCP is open. Android displays a persistent notification while the service keeps the same connection and tool handlers active. The app retries after network changes or server restarts; your phone and desktop must remain reachable over your local network or VPN.

Reopen PhonePi MCP after force-stopping it or restarting the phone. Continuous background connections are Android-only; keep the iOS app open. Camera capture and the SMS composer require the app to be in the foreground. send_sms prepares a message in your messaging app, where you confirm sending; a successful composer launch does not confirm delivery.

To report a connection problem, include the app version, Android version, phone model, server version, and whether the failure occurs when enabling the service or after a network change.

Contributing

We welcome contributions from the community! Here's how you can contribute:

1. Fork the Repository

   • Create your own fork of the code
   • Make your changes in a new branch

2. Code Style

   • Follow the existing code style and conventions
   • Include comments where necessary
   • Write clear commit messages

3. Testing

   • Wait for the maintainer to test your changes

4. Submit a Pull Request

   • Provide a clear description of the changes
   • Reference any related issues
   • Wait for review and address any feedback

License

This project is licensed under the MIT License - see the LICENSE file for details.

Security

If you discover any security-related issues, please open an issue instead of using the issue tracker.