@textbee/mcp

MCP-Server für textbee.dev, das Open-Source-SMS-Gateway, das ein Android-Telefon in eine SMS-API verwandelt. Gibt Claude Desktop, Claude Code, Cursor und jedem MCP-Client die Möglichkeit, SMS über dein eigenes Telefon und deine eigene Nummer zu senden und zu lesen.

Drei Tools, kein Aufschlag pro Nachricht, funktioniert mit selbst gehosteten textbee-Instanzen.

Setup

Du benötigst ein textbee-Konto mit einem gekoppelten Android-Gerät und einen API-Schlüssel aus dem Dashboard. Der Schlüssel hat vollen Kontozugriff; behandle ihn wie ein Passwort.

Claude Code

claude mcp add textbee -s user -e TEXTBEE_API_KEY=your-key -- npx -y @textbee/mcp

Claude Desktop

Füge Folgendes zu claude_desktop_config.json hinzu (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "textbee": {
      "command": "npx",
      "args": ["-y", "@textbee/mcp"],
      "env": { "TEXTBEE_API_KEY": "your-key" }
    }
  }
}

Cursor

Dasselbe Objekt in ~/.cursor/mcp.json.

Langsamer erster Start

npx lädt das Paket beim ersten Start herunter. Wenn dein Client beim Warten ein Timeout hat, installiere es einmal global und weise die Konfiguration auf die Binärdatei:

npm install -g @textbee/mcp

{ "mcpServers": { "textbee": { "command": "textbee-mcp", "env": { "TEXTBEE_API_KEY": "your-key" } } } }

Related MCP server: commune-mcp

Tools

send_sms

Sende eine SMS an einen oder mehrere Empfänger (E.164-Format, zum Beispiel +15550100123). Das sendende Telefon wird automatisch gewählt: dein Standardgerät, andernfalls das aktivierte Gerät mit dem neuesten Heartbeat. Optional device_id, sim_subscription_id und scheduled_at. Gibt eine sms_batch_id für Zustellprüfungen zurück, wenn das Konto die SMS-Warteschlange verwendet.

get_messages

Lies Nachrichten von allen Geräten des Kontos. Standardmäßig werden empfangene Nachrichten angezeigt, neueste zuerst. Filtere nach direction (received, sent, all), Freitext-search, sms_batch_id (Zustellstatus pro Empfänger einer Sendung), device_ids und einem from/to-Zeitfenster. Unterstützt Cursor-Pagination für Polling ohne Duplikate oder Lücken.

list_devices

Die Telefone des Kontos: IDs, Aktivierungsstatus, welches standardmäßig sendet, letzter Check-in und Nachrichtenzahlen.

Selbst gehostetes textbee

Weise den Server auf deine eigene Instanz hin:

"env": {
  "TEXTBEE_API_KEY": "your-key",
  "TEXTBEE_BASE_URL": "https://sms.example.com"
}

Das Suffix /api/v1 ist optional und wird automatisch hinzugefügt. Subpfad-Bereitstellungen wie https://example.com/textbee funktionieren ebenfalls. Eine ungültige URL ist ein Fehler und kein stiller Fallback, sodass ein Tippfehler deinen Schlüssel niemals an die öffentliche API sendet.

Umgebungsvariablen

Hinweise

• Dein Schlüssel bleibt auf deinem Rechner: Dieser Server spricht nur mit der textbee-API unter der obigen Basis-URL.

• Sendungen zählen gegen dein textbee-Plan-Kontingent, und die Ratenlimits des Plans gelten serverseitig.

• Alle Diagnosen gehen an stderr; stdout ist für das MCP-Protokoll reserviert.

Verwendung als Bibliothek

Das Paket exportiert auch seine Tool-Definitionen zur Einbettung in einen anderen MCP-Host (so verwendet der gehostete Remote-Endpunkt sie wieder):

import { createTextbeeMcpServer, staticCredentials, loadConfig } from '@textbee/mcp'

const server = createTextbeeMcpServer({
  credentials: staticCredentials(loadConfig(process.env)),
})

Anmeldeinformationen werden pro Tool-Aufruf aufgelöst, sodass ein Multi-Tenant-Host pro Anfrage einen anderen Schlüssel einfügen kann. Siehe credentialsFromAuthInfoExtra.

Lizenz

MIT. Teil des textbee-Projekts.