一个强大的MCP服务器及其配套应用，允许你通过喜欢的MCP支持的AI应用（如Cursor和Claude Desktop）使用自然语言命令远程管理和控制手机。该项目提供了一套全面的工具和API，用于程序化地与移动设备交互。

概述

电话MCP允许您：

• 管理联系人和消息
• 处理摘要和注释
• 控制手机设置和通知
• 准备短信确认并拨打电话
• 跨应用分享内容
• 监测电池状态
• 设置计时器和提醒
• 用音频提醒查找你的手机

安全

安全是高度关注的。以下是关于安全的几个方面：

• 你完全负责本地托管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