twilio-mcp-server

Twilio MCP

Un servidor MCP para comunicaciones de Twilio. Envía mensajes SMS, MMS y WhatsApp. Realiza llamadas de voz. Gestiona números de teléfono.

Qué hace

Conecta tu cuenta de Twilio a cualquier cliente MCP. Envía mensajes de texto, comparte imágenes, realiza llamadas telefónicas y gestiona tus números de teléfono mediante lenguaje natural.

Herramientas

• send_sms. Envía un mensaje de texto SMS.
• send_mms. Envía un mensaje MMS con una imagen o archivo multimedia.
• send_whatsapp. Envía un mensaje de WhatsApp.
• get_message_status. Consulta el estado de entrega de un mensaje enviado.
• list_messages. Consulta el historial reciente de mensajes con filtros.
• make_call. Inicia una llamada de voz con control TwiML.
• list_calls. Consulta el historial reciente de llamadas.
• list_numbers. Lista tus números de teléfono de Twilio.
• search_numbers. Busca números de teléfono disponibles por código de área.

Autenticación

Configura estas variables de entorno:

export TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export TWILIO_AUTH_TOKEN="your-auth-token"

Encuéntralas en el panel de control de tu consola de Twilio.

Instalación

npx twilio-mcp

Configuración de Claude Desktop

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": ["-y", "twilio-mcp"],
      "env": {
        "TWILIO_ACCOUNT_SID": "ACxxxxxxxx",
        "TWILIO_AUTH_TOKEN": "your-token"
      }
    }
  }
}

Ejemplo de uso

Pregunta a Claude:

"Envía un SMS al +14155551234 que diga 'Hola desde Claude' desde mi número de Twilio"

"Envía un mensaje de WhatsApp al +14155551234 con esta imagen adjunta"

"¿Cuál es el estado de entrega del mensaje SM1234567890?"

"Lista mis mensajes recientes del último día"

"Llama al +14155551234 y reproduce un mensaje usando esta URL TwiML"

"Lista mis números de teléfono de Twilio"

"Busca números de teléfono disponibles en el código de área 415"

Llamadas de voz

Para realizar llamadas, necesitas una URL TwiML que controle el flujo de la llamada. Puedes usar TwiML Bin en la consola de Twilio o alojar tu propio TwiML. Ejemplo de TwiML:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Say voice="alice">Hello, this is a call from your AI assistant.</Say>
</Response>

Licencia

MIT