Skip to content
MCP server

phone-sms

Read and send SMS from your own Android phone over KDE Connect, with no cloud relay

Runs locallyStatus and history
Pricing
Open source
Platforms
Linux, Android, CLI
Runs
Locally
Version
0.1.0
Listing updated
1 day ago

About phone-sms

phone-sms is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

This server is the model-facing half of the kdeconnect-sms desktop app. It talks to the KDE Connect daemon on your Linux computer over D-Bus, the daemon reaches your Android phone across the local network, and the phone sends texts from your own number. There is no SMS gateway, relay or extra account, and the site says it keeps no copy, log or database of your messages.

Four tools do the work: list recent conversations (with filters for a name, number fragment or unread), read the last messages of a thread, look up a contact from the contacts the phone shares, and send a text or group text. The send tool carries MCP's destructive hint and the server instructs the model not to send until you have approved the exact recipient and wording. A command line mirrors the tools so you can check whether a problem lies with the model, the server or the phone.

It needs Linux with a D-Bus session bus and KDE Connect, an Android phone with the KDE Connect app and its SMS plugin enabled, and uv with Python 3.12 or later. It runs without the Plasma desktop. The server is GPL-3.0-or-later and the bundled skill is MIT. The author built it on a Pixel 7 with GrapheneOS.

Install

Run in a terminal

claude mcp add phone-sms -- uvx phone-sms

Add to claude_desktop_config.json

{
  "mcpServers": {
    "phone-sms": {
      "command": "uvx",
      "args": [
        "phone-sms"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "phone-sms": {
      "command": "uvx",
      "args": [
        "phone-sms"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "phone-sms": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "phone-sms"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "phone-sms": {
      "command": "uvx",
      "args": [
        "phone-sms"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "phone-sms": {
      "command": "uvx",
      "args": [
        "phone-sms"
      ]
    }
  }
}

Configuration

  • PHONE_SMS_DEVICEKDE Connect device id to use when several phones are paired (kdeconnect-cli -l)

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

list_threads
Conversations newest first with the latest message
read_thread
Last n messages of one conversation
find_contact
Look up a contact by name or number fragment
send_sms
Send a text or group text

What it does

Conversation listing
Lists threads newest first with the latest message, filtered by name, number or unread.
Thread reading
Reads the last messages of a conversation with names in place of numbers.
Contact lookup
Finds a contact by name or number fragment from the phone's synced contacts.
Approval-gated sending
Sends single or group texts only after you approve recipient and text.
Local network only
Messages travel phone to computer over KDE Connect, with no cloud relay.
Matching CLI
A phone-sms command runs the same code paths as the tools.

Good for

  • Have an assistant summarise unread texts
  • Read a verification code from a recent message
  • Draft and send a reply from your own number after approving it
  • Look up a friend's number before messaging

Pricing

Open source

Free; GPL-3.0-or-later

Prices change. Check phone-sms.vercel.app before you buy.

phone-sms FAQ

Does it use a cloud service or SMS gateway?

No. It reaches your phone over KDE Connect on your local network.

What do I need installed?

Linux with KDE Connect and D-Bus, an Android phone with the KDE Connect app and SMS plugin, and uv with Python 3.12 or later.

Will it send messages without asking?

The send tool is marked destructive and the server tells the model to wait for your approval of the exact recipient and text.

Can I use several phones?

Yes. Set PHONE_SMS_DEVICE to the device ID shown by kdeconnect-cli -l.

Is phone-sms free?

Yes. phone-sms is open source, so you can use and self-host it for free.

How do I add phone-sms to Claude Code?

Run this command in your terminal: claude mcp add phone-sms -- uvx phone-sms

What are the best alternatives to phone-sms?

The closest alternatives to phone-sms are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to phone-sms

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity