Skip to content
MCP server

textbee SMS

Send and read SMS from your AI through your own Android phone and number

Runs locallyStatus and history
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/mcp

Add 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).Required
  • TEXTBEE_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

  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