
phone-sms
Read and send SMS from your own Android phone over KDE Connect, with no cloud relay
- 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-smsAdd to claude_desktop_config.json
{
"mcpServers": {
"phone-sms": {
"command": "uvx",
"args": [
"phone-sms"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"phone-sms": {
"command": "uvx",
"args": [
"phone-sms"
]
}
}
}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

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity