README.md•2.48 kB
# 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
- Send SMS 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](https://phonepimcp.com)
## Support & Issues
If you encounter any bugs or have feature requests, please [open an issue](https://github.com/yourusername/phone-mcp/issues) on our GitHub repository. We actively monitor and respond to issues.
## 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.