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

by priyankark

35 stars
608 downloads
Not rated
GitHub Website

About

PhonePi MCP enables seamless integration between desktop AI tools and your smartphone, providing 23+ direct actions including SMS messaging, phone calls, contact management, snippet creation and search, clipboard sharing, notifications, battery status checks, and remote device co

Details

Author
priyankark
GitHub stars
35
Downloads
608
Categories
Communication, AI, Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name PhonePi MCP: Turn your phone into a toolbox for AI assistants using Model Context Protocol
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

You host the MCP server locally (source code is fully open source) and install the companion app on your phone. The app and server communicate over your local network; no third-party remote servers are involved. For detailed instructions, visit the project’s official website.

get_battery_level

Get the current battery level of the phone

add_snippet

Add a new snippet to the phone

get_all_snippets

Get all snippets from the phone

get_snippet_by_id

Get a specific snippet by ID

get_snippets_by_type

Get snippets by type

search_snippets

Search snippets by query

update_snippet

Update an existing snippet

delete_snippet

Delete a snippet from the phone

send_sms

Send an SMS message

make_call

Make a phone call

find_phone

Make the phone beep to help locate it

set_timer

Set a timer for a specific duration

copy_to_clipboard

Copy text to the phone clipboard

get_contacts

Get all contacts from the phone

get_contact_by_id

Get a specific contact by ID

add_contact

Add a new contact to the phone

update_contact

Update an existing contact

delete_contact

Delete a contact from the phone

share_snippet

Share a snippet via messaging apps

send_message

Send a message to the phone that requires user attention or response

get_message_response

Get the response to a previously sent message

send_notification

Send a notification to the phone

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "phonepi mcp: turn your phone into a toolbox for ai assistants using model context protocol": {
            "phonepi-mcp": {
                "command": "npx",
                "args": [
                    "phonepi-mcp",
                    "start"
                ]
            }
        }
    }
}

McpServers

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

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

Support & Issues

If you encounter any bugs or have feature requests, please open an issue 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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.