PhonePi logo

PhonePi

Community
priyankark

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 controls.

Publisherpriyankark
Repositoryphonepi-mcp
LanguageJavaScript
Forks
5
Stars
34
Available tools
22
Transport typestdio
Categories
CommunicationDeveloper Tools
LicenseMIT
Links
GitHubHomepage
  • Connect tools to AI workflows

    PhonePi exposes MCP capabilities that can be used by compatible AI clients and agents.

  • 22 available tools

    Browse the callable actions below, including names and descriptions when provided by the server.

  • Ready-to-copy setup

    Use the installation snippets to configure this server in your preferred MCP client.

  • Open source signals

    34 stars and 5 forks from the linked repository.

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.

Installation

TypingMind
Prerequisites:

Node.js 18+

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

Available Tools

  • 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

Use PhonePi MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once PhonePi is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. This MCP runs locally through the TypingMind MCP connector on your device.

Setup guide to use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

1

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

  1. Open TypingMind in your browser.
  2. Click the Settings icon.
  3. Go to Advanced Settings.
  4. Open the Model Context Protocol section.
  5. Click Setup Connector and choose This Device.
TypingMind MCP connector setup screen with This Device selected
2

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

  1. Copy the setup command shown by TypingMind.
  2. Open Terminal on macOS or Windows Terminal on Windows.
  3. Paste and run the command.
  4. Approve the package install if Terminal asks you to proceed.
  5. Keep the Terminal window running while using MCP tools.
3

Add PhonePi as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

  1. Wait until the connector status shows Ready.
  2. Click Edit Servers.
  3. Paste the PhonePi MCP server configuration.
  4. Save the server list.
  5. Refresh if you want to confirm the connector is still ready.
TypingMind MCP settings showing active server and Edit Servers button
{
  "mcpServers": {
    "phonepi": {
      "command": "npx",
      "args": [
        "-y",
        "phonepi-mcp"
      ]
    }
  }
}
4

Use it across models

Save the server list, open Plugins, enable the PhonePi MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

  1. Open the Plugins page in TypingMind.
  2. Enable the PhonePi MCP tools.
  3. Start a chat and choose the AI model you want to use.
  4. Use the MCP tools in chat or assign them to an AI agent.
  5. Switch to another AI model whenever needed without reconnecting MCP.
TypingMind chat using enabled MCP tools with a selected AI model
Can you use PhonePi to help me with this task?
PhonePi
Sure. I read it.
Here is what I found using PhonePi.

Frequently asked questions

What is the PhonePi MCP server used for?

PhonePi is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use PhonePi MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use PhonePi with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use PhonePi MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With PhonePi connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect PhonePi MCP to TypingMind?

PhonePi runs through the TypingMind local MCP connector. This is best when the MCP server needs access to local files, desktop apps, command-line tools, or private resources on your computer.

What tools does PhonePi MCP provide in TypingMind?

PhonePi exposes 22 MCP tools that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use PhonePi MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If PhonePi requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

Related MCP Servers

View all
microsoft logo

Microsoft Outlook

microsoft
CommunityPopular

Microsoft Outlook MCP server. Read, search, and send emails, manage calendar events, and handle contacts via Microsoft Graph API. Works with personal and work accounts.

0
7.6K
18 tools
View details
lharries logo

WhatsApp MCP

lharries
CommunityPopular

WhatsApp MCP server

1K
5.6K
0 tools
View details
simple-workshop logo

Mailchimp

simple-workshop
CommunityPopular

Mailchimp MCP server. Manage audiences, campaigns, automations, and templates. Send emails, track opens/clicks, and analyze performance metrics from AI clients.

0
2.8K
17 tools
View details
taylorwilsdon logo

Google Workspace MCP

taylorwilsdon
CommunityPopular

Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace / G Suite MCP Server & CLI Tool

729
2.4K
0 tools
View details

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇