# phone-sms

> phone-sms is an open-source MCP server for communication. Read and send SMS from your own Android phone over KDE Connect, with no cloud relay. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, Android, CLI, self-hosted
- **Website:** https://phone-sms.vercel.app
- **Repository:** https://github.com/h-3303/phone-sms
- **MCP Registry name:** io.github.h-3303/phone-sms
- **Categories:** communication
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add phone-sms -- uvx phone-sms
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/phone-sms
