textbee SMS
Send and read SMS from your AI through your own Android phone and number
- Pricing
- Freemium
- Platforms
- Android, API, self-hosted
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 3 days ago
About textbee SMS
textbee SMS is a freemium MCP server for communication. It runs locally on your machine and is started by your AI client.
Texts leave from your own paired Android phone, not a rented number, so there is no per-message markup on top of your textbee plan. The agent can text one or many recipients, schedule a send, pick a device or SIM slot, then check delivery or wait for a reply. If the chosen SIM slot is empty the message fails rather than going out from another SIM.
Three tools cover the job: send_sms, get_messages and list_devices. The message reader works across every device on the account, with cursor pagination, and can pick up a one-time passcode. Plan limits are enforced server-side, so a runaway agent loop cannot outspend the plan.
There are two ways to connect. Claude's web, desktop and mobile apps use a hosted endpoint where you paste your API key on a sign-in page and reconnect every 90 days. The site states the trade-off plainly: the key passes through textbee's server, though it is not stored or logged. To keep the key on your machine, run the MIT-licensed npm package locally, optionally pointed at a self-hosted textbee instance.
Install
Run in a terminal
claude mcp add mcp --env TEXTBEE_API_KEY='<TEXTBEE_API_KEY>' -- npx -y @textbee/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@textbee/mcp"
],
"env": {
"TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@textbee/mcp"
],
"env": {
"TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@textbee/mcp"
],
"env": {
"TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@textbee/mcp"
],
"env": {
"TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@textbee/mcp"
],
"env": {
"TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
}
}
}
}Configuration
TEXTBEE_API_KEYAPI key from the textbee dashboard (app.textbee.dev/dashboard).RequiredTEXTBEE_BASE_URLSelf-hosted instance URL. Defaults to https://api.textbee.dev; the /api/v1 suffix is added automatically.
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- send_sms
- Sends an SMS to one or more numbers, with optional device, SIM and scheduled time.
- get_messages
- Reads messages across devices, including replies, OTPs and delivery status.
- list_devices
- Lists the phones on the account, the default sender and last check-in.
What it does
- Send SMS
- Texts one or many recipients, with optional device, SIM slot and scheduled time.
- Read replies and codes
- get_messages waits for replies, picks up OTPs and checks delivery status.
- Multi-device view
- list_devices shows paired phones, the default sender and last check-in.
- Your own number
- Messages go out through your Android phone, with no per-message markup.
- Plan limits enforced
- Server-side limits stop a looping agent overspending.
- Hosted or local
- Use a hosted connector for Claude apps or run the npm package locally.
- Self-host friendly
- A TEXTBEE_BASE_URL setting points it at your own textbee instance.
Good for
- Text a customer that a deploy finished and confirm delivery
- Wait for a bank verification code and read it back
- Check whether anyone replied to a reminder
- Send scheduled texts from a chosen SIM
- Give an agent SMS through a self-hosted gateway
Pricing
Freemium
Free: 300 messages a month on 1 device; Pro and Scale plans are paid, prices not shown; server is MIT licensed
Prices change. Check textbee.dev before you buy.
textbee SMS FAQ
Do I need an Android phone?
Yes. Messages are sent and read through your own paired Android phone using the textbee app.
Does it cost extra per message?
The site says there is no per-message markup; messages count against your textbee plan limits.
What are the plan limits?
Free allows 1 device, 50 messages a day and 300 a month. Pro allows 5 devices and 5,000 a month; Scale 15 devices and 25,000 a month.
Does my API key leave my machine?
With the hosted connector it passes through textbee's server, which does not log or store it. The local npm server keeps it in your client config.
Which tools are exposed?
send_sms, get_messages and list_devices.
Is textbee SMS free?
textbee SMS has a free plan, with paid plans for more usage or features.
How do I add textbee SMS to Claude Code?
Run this command in your terminal: claude mcp add mcp --env TEXTBEE_API_KEY='<TEXTBEE_API_KEY>' -- npx -y @textbee/mcp
What are the best alternatives to textbee SMS?
The closest alternatives to textbee SMS are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to textbee 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