mcp-twilio — MCP-сервер для Claude Code: SMS, WhatsApp и звонки
Подключает Twilio к агенту: отправка SMS и WhatsApp, голосовые звонки, 2FA через Verify и проверка номеров через Lookup.
claude mcp add --env TWILIO_ACCOUNT_SID=<TWILIO_ACCOUNT_SID> --env TWILIO_AUTH_TOKEN=<TWILIO_AUTH_TOKEN> --env TWILIO_MESSAGING_SERVICE_SID=<TWILIO_MESSAGING_SERVICE_SID> --transport stdio twilio -- npx -y @codespar/mcp-twilioЧто делает mcp-twilio
Сервер даёт агенту 22 инструмента Twilio. send_message отправляет SMS или сообщение в WhatsApp, make_call звонит по номеру, start_verification и check_verification проводят код подтверждения через Verify, а lookup_phone проверяет и нормализует номер по Lookups v2. Отдельная группа инструментов заведует Conversations, Messaging Services, Studio Flows и TaskRouter — от создания разговора до постановки задачи в очередь воркеров.
Понадобятся TWILIO_ACCOUNT_SID и TWILIO_AUTH_TOKEN, без них сервер не авторизуется. Basic auth с парой AccountSid:AuthToken сервер собирает сам, вручную заголовок прописывать не нужно. Для WhatsApp номер в поле To идёт с префиксом whatsapp:, например whatsapp:+5511999999999, и отправитель тоже должен быть WhatsApp-совместимым. TWILIO_MESSAGING_SERVICE_SID задаёт отправителя по умолчанию для send_message. Verify работает только с Service SID, который передаётся в каждом вызове.
Запуск по умолчанию — stdio, этого хватает Cursor и Claude Desktop. Для тестов между серверами есть HTTP-режим: MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-twilio. Покупать номера и слать реальные сообщения агент будет с вашего аккаунта Twilio и по его тарифам — доступ к инструментам buy_phone_number и delete_message стоит ограничить, если агент работает без присмотра.
Какие задачи решает
- отправить SMS или сообщение в WhatsApp из задачи агента
- подтвердить номер клиента кодом из Verify
- проверить и нормализовать телефонный номер перед записью в базу
- позвонить по номеру и посмотреть запись разговора
- завести номер и добавить участника в Twilio Conversation
Примеры запросов агенту
- Отправь SMS на +5511999999999 с текстом «Заказ готов» через
send_message - Проверь номер +14155552671 через
lookup_phoneи скажи, мобильный ли это - Запусти проверку кода из Verify для этого Service SID и сверь, что клиент ввёл
check_verification
Как установить mcp-twilio
Командой платформы
claude mcp add --env TWILIO_ACCOUNT_SID=<TWILIO_ACCOUNT_SID> --env TWILIO_AUTH_TOKEN=<TWILIO_AUTH_TOKEN> --env TWILIO_MESSAGING_SERVICE_SID=<TWILIO_MESSAGING_SERVICE_SID> --transport stdio twilio -- npx -y @codespar/mcp-twilioВместо <…> подставьте свои значения
Командой платформы
codex mcp add twilio --env TWILIO_ACCOUNT_SID=<TWILIO_ACCOUNT_SID> --env TWILIO_AUTH_TOKEN=<TWILIO_AUTH_TOKEN> --env TWILIO_MESSAGING_SERVICE_SID=<TWILIO_MESSAGING_SERVICE_SID> -- npx -y @codespar/mcp-twilioВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"twilio": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-twilio"
],
"env": {
"TWILIO_ACCOUNT_SID": "<TWILIO_ACCOUNT_SID>",
"TWILIO_AUTH_TOKEN": "<TWILIO_AUTH_TOKEN>",
"TWILIO_MESSAGING_SERVICE_SID": "<TWILIO_MESSAGING_SERVICE_SID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"twilio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-twilio"
],
"env": {
"TWILIO_ACCOUNT_SID": "<TWILIO_ACCOUNT_SID>",
"TWILIO_AUTH_TOKEN": "<TWILIO_AUTH_TOKEN>",
"TWILIO_MESSAGING_SERVICE_SID": "<TWILIO_MESSAGING_SERVICE_SID>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e TWILIO_ACCOUNT_SID=<TWILIO_ACCOUNT_SID> -e TWILIO_AUTH_TOKEN=<TWILIO_AUTH_TOKEN> -e TWILIO_MESSAGING_SERVICE_SID=<TWILIO_MESSAGING_SERVICE_SID> twilio npx -y @codespar/mcp-twilioВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-twilio
Как установить mcp-twilio в Claude Code?
Выполните claude mcp add mcp-twilio -e TWILIO_ACCOUNT_SID=<TWILIO_ACCOUNT_SID> -e TWILIO_AUTH_TOKEN=<TWILIO_AUTH_TOKEN> -- npx -y @codespar/mcp-twilio. Либо вторую форму с явным stdio-транспортом: `claude mcp add --env TWILIO_ACCOUNT_SID=<TWILIO_ACCOUNT_SID> --env TWILIO_AUTH_TOKEN=<TWILIO_AUTH_TOKEN> --env TWILIO_MESSAGING_SERVICE_SID=<TWILIO_MESSAGING_SERVICE_SID> --transport stdio twilio -- npx -y @codespar/mcp-twilio`.
Что делает mcp-twilio?
Даёт агенту инструменты Twilio для SMS, WhatsApp, голосовых звонков, двухфакторной проверки через Verify и валидации номеров через Lookups. Плюс работа с Conversations, Messaging Services, Studio Flows и TaskRouter.
Отправляет ли сервер WhatsApp так же, как SMS?
Да, через тот же send_message. Номер получателя и отправителя указывайте с префиксом whatsapp:, к примеру whatsapp:+5511999999999.
