# textbee SMS

> textbee SMS is a freemium MCP server for communication. Send and read SMS from your AI through your own Android phone and number. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Android, API, self-hosted, CLI
- **Website:** https://textbee.dev/mcp
- **Repository:** https://github.com/textbee/textbee-mcp
- **MCP Registry name:** io.github.textbee/mcp
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env TEXTBEE_API_KEY='<TEXTBEE_API_KEY>' -- npx -y @textbee/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@textbee/mcp"
      ],
      "env": {
        "TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@textbee/mcp"
      ],
      "env": {
        "TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@textbee/mcp"
      ],
      "env": {
        "TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@textbee/mcp"
      ],
      "env": {
        "TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@textbee/mcp"
      ],
      "env": {
        "TEXTBEE_API_KEY": "<TEXTBEE_API_KEY>"
      }
    }
  }
}
```

## Tools

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

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

- [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/textbee-sms
