PlugWiki
textbee SMS logo

textbee SMS MCP Server: Setup for Claude Code, Cursor and Other Apps

OfficialLocal
Getnpm@textbee/mcptextbee/textbee-mcp
Tools
3
2 read · 1 change
Stars
1
on GitHub
Downloads
34
a week
Works in
12
apps
Risk
Medium
can write

Lets Claude, Cursor and other assistants send and read text messages through your own Android phone and number.

textbee turns an Android phone into an SMS gateway. This is its own MCP server, so your assistant can text people, read replies and check codes that arrive on your phone.

You need a textbee account, a paired Android phone and an API key from the textbee dashboard. It runs on your machine with npx, and it also works with self-hosted textbee.

Texts go out from your real number through your phone's SIM, so your carrier plan pays for them, and they also count against your textbee plan limits. textbee adds no per-message markup.

Good for

  • People who want an assistant to text for them from their own number
  • Developers testing sign-up flows that send verification codes by SMS
  • Self-hosters who run their own textbee server

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install textbee SMS MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the textbee SMS MCP server to Claude Code. Run this command:

claude mcp add textbee-sms -e TEXTBEE_API_KEY=<TEXTBEE_API_KEY> -- npx -y @textbee/mcp

Ask me for TEXTBEE_API_KEY and only put the values in that config, nowhere else.

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

You need a textbee account with a paired Android phone and an API key from app.textbee.dev/dashboard (the key has full account access). Texts go out through that phone's SIM, so your carrier plan applies as well as textbee's plan limits. The local npx server keeps the key on your machine. The hosted endpoint https://mcp.textbee.dev/mcp signs you in with the key; textbee says it checks the key without storing it, but the key passes through its server, and a connection lasts 90 days. textbee documents the hosted setup for claude.ai, Claude Desktop, Claude Code and Cursor; configs for other clients are our adaptation of the documented URL and header. Self-hosting: set TEXTBEE_BASE_URL on the local server.

Built from the package data we hold. Not yet tested by us.

Tools

  • Sends a text message from your Android phone

    Sends an SMS to one or more numbers in international format. It picks your default phone, or the enabled one that checked in most recently, and can schedule a send for later. It returns a batch ID so you can check delivery.

    Try: “Text +15550100123 that I am running ten minutes late.”

    Write · send_sms

  • Reads texts sent and received on your phones

    Returns messages across all your devices, newest received first by default. You can filter by direction, search words, a send batch or a time window, and page through results.

    Try: “Find the verification code I just received.”

    Network · get_messages

  • Lists the phones linked to your account

    Shows each phone with its ID, whether it is enabled, which one sends by default, when it last checked in and its message counts.

    Try: “Which of my phones is the default sender?”

    Network · list_devices

Read from the source code

Permissions

medium risk · 4 things to watch

Medium risk

It can send real text messages from your number and read every message on your linked phones. Approve each send, and keep the API key private because it has full access to your textbee account.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It sends texts from your own number

    Messages go to real people from your SIM. Your carrier plan covers the cost (textbee adds no per-message fee), and sends also count against your textbee plan quota. Ask the assistant to show the text and recipients before it sends. github.com

  • It can read all your messages

    The message tool reads texts across every linked phone, including codes and private chats. Do not use it on a phone with messages you would not share with the assistant. github.com

  • The API key has full account access

    The README says to treat it like a password. Regenerate it in the dashboard if it leaks. github.com

  • The hosted connector passes your key through textbee's server

    With the hosted endpoint (mcp.textbee.dev), the README says textbee checks the API key and does not store it, but the key passes through its server. The local npx setup keeps the key on your machine. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks toapi.textbee.dev, or the self-hosted address you set (local setup). mcp.textbee.dev (hosted connector)
Sign-in and keysLocal npx: the API key is set in the TEXTBEE_API_KEY environment variable in your client config and stays on your machine. Hosted connector: you paste the key on textbee's sign-in page; the README says it is checked and not stored, but it passes through textbee's server.
Scopes

  • Full textbee account access (the key is not limited)

Questions

Is this the official textbee MCP server?

Yes. It ships from the textbee GitHub organization, and the main textbee README links to it as its official MCP server.

What do I need before installing it?

A textbee account, an Android phone paired to it, and an API key from the textbee dashboard. Put the key in TEXTBEE_API_KEY, as the install box shows.

Does it work with a self-hosted textbee?

Yes. Set TEXTBEE_BASE_URL to your server address. An invalid address is an error, so your key is not sent to the public API by mistake.

Can I use it in claude.ai or the Claude mobile apps?

Yes, through the hosted connector. Add https://mcp.textbee.dev/mcp as a custom connector in claude.ai or Claude Desktop and sign in with your API key; the README says the connection also works in the mobile apps and lasts 90 days. The key passes through textbee's server (not stored, per the README); the local npx setup keeps it on your machine.

Can it send texts without asking?

It sends whenever your assistant calls the send tool, so keep your client's tool approval on. There is no read-only mode.

Who pays for the text messages?

You do, through your own phone plan. Texts are sent by the Android phone's SIM, so your carrier plan covers each message, and textbee says it adds no per-message markup. Sends also count against your textbee plan quota, and the plan's rate limits apply.

Is it free?

The server is free and MIT licensed. Each text still uses your carrier plan, and sends count against your textbee plan quota and rate limits. The textbee README says there is a free hosted plan; check textbee for current limits.

Information

updated Nov 2, 2026

Publisher
Official
Package
@textbee/mcp
Registry
npm
Transport
stdio
Auth
API key
Version
0.1.0
License
MIT
Last commit
Oct 28, 2026
Open issues
0
Listed in
Official MCP registry

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 4
  1. @textbee/mcp README · github.com
  2. @textbee/mcp on npm · npmjs.com
  3. textbee README · github.com
  4. @textbee/mcp tools.ts · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.