Мощный MCP-сервер и сопутствующее приложение, которое позволяет управлять и управлять телефоном удаленно, используя команды естественного языка через любимые приложения с поддержкой MCP, такие как Cursor и Claude Desktop. Этот проект предоставляет полный набор инструментов и API для программного взаимодействия с вашим мобильным устройством.

Обзор

Телефон MCP позволяет: Управлять контактами и сообщениями

• Обработка фрагментов и заметок
• Управление настройками телефона и уведомлениями Подготовьте SMS-сообщения для подтверждения на вашем телефоне и звоните Делиться контентом через приложения Состояние батареи монитора Установите таймеры и напоминания Найдите свой телефон с аудио оповещениями

Безопасность

Безопасность вызывает серьезную озабоченность. Вот несколько аспектов, учитываемых в сфере безопасности: Вы полностью отвечаете за локальный хостинг MCP-сервера. Код полностью открытый. На фронте приложения вы отвечаете за то, какие разрешения давать в зависимости от функций, которые вы хотите использовать. Приложение и сервер связаны через локальную сеть. Нет 3p удаленных серверов, участвующих в соединении. Рекомендуется использовать это приложение в безопасной сети. Избегайте общественных сетей, таких как аэропорты и рестораны.

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