Agent skill
twilio-sms
Install this agent skill to your Project
npx add-skill https://github.com/idanbeck/claude-skills/tree/main/twilio-sms
SKILL.md
Twilio SMS Skill - Text Message Bridge for Claude Code
Send and receive SMS/MMS messages through Twilio, with auto-response via Claude Code.
Setup
1. Get Twilio Credentials
- Sign up at https://www.twilio.com/
- Get a phone number (or use trial number)
- Find your Account SID and Auth Token in the console
2. Configure the Skill
Create config.json:
{
"account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"auth_token": "your_auth_token_here",
"phone_number": "+1234567890",
"allowed_numbers": ["+1987654321"]
}
account_sid: Your Twilio Account SIDauth_token: Your Twilio Auth Tokenphone_number: Your Twilio phone number (the one that sends/receives)allowed_numbers: List of phone numbers allowed to interact (for security)
3. Install Dependencies
pip install twilio flask
4. Set Up Webhook (for receiving messages)
The bridge needs a public URL for Twilio webhooks. Options:
Option A: ngrok (for local development)
# Terminal 1: Start the bridge
python ~/.claude/skills/twilio-sms/twilio_bridge.py --auto
# Terminal 2: Expose with ngrok
ngrok http 5001
Then set the ngrok URL in Twilio Console -> Phone Numbers -> Your Number -> Messaging -> Webhook URL: https://xxxx.ngrok.io/sms
Option B: Deploy to server Deploy twilio_bridge.py to a server with a public URL.
CLI Usage
# Send an SMS
python twilio_skill.py send +1234567890 -m "Hello from Claude!"
# Send MMS (with image URL)
python twilio_skill.py send +1234567890 -m "Check this out" --media https://example.com/image.png
# Read recent inbox
python twilio_skill.py inbox
# Check conversation history with a number
python twilio_skill.py history +1234567890
# Check Twilio account status
python twilio_skill.py status
Bridge Mode (Auto-Response)
# Start the bridge with auto-respond
python twilio_bridge.py --auto --workdir /path/to/workspace
# Start in background
python twilio_bridge.py --auto --daemon
# Check status
python twilio_bridge.py --status
# Stop
python twilio_bridge.py --stop
# View inbox
python twilio_bridge.py --inbox
Features
- Auto-response: Incoming SMS triggers Claude Code, response sent back
- Conversation tracking: Maintains context across messages from same number
- Progress updates: Sends "Working on it..." for long-running tasks
- MMS support: Can send images (requires public URL)
- Security: Only responds to allowed phone numbers
Required Twilio Permissions
- Send SMS/MMS
- Receive SMS/MMS (webhook)
- Phone number with SMS capability
Files
twilio_skill.py- CLI for sending messagestwilio_bridge.py- Webhook server for auto-responseconfig.json- Twilio credentials (create this)inbox.jsonl- Received messages log
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
fal-video-skill
godaddy-skill
Manage GoDaddy domains and DNS records. Use when the user asks to set up DNS, manage domain records, check DNS propagation, point domains to servers, or configure A/AAAA/CNAME/MX/TXT records. Supports bulk operations for quick domain setup.
gcal-skill
Read, create, and manage Google Calendar events. Use when the user asks to check calendar, view schedule, find meetings, create events, or see what's on the agenda. Supports multiple accounts.
nano-banana-pro
Generate images using AI. Use when the user asks to create, generate, or make images, pictures, graphics, illustrations, visuals, or artwork. Also use for image editing with reference images.
google-docs-skill
Create, read, update, share, and export Google Docs. Use when the user asks to create documents, write content to Google Docs, share docs, export to PDF/DOCX, or convert markdown files to Google Docs.
film-maker-skill
Didn't find tool you were looking for?