Better Call Claude

Bi-directional communication for Claude Code via Voice Calls, SMS, and WhatsApp.
Call Claude from your phone to start tasks, and receive callbacks when Claude needs input or wants to share status.

📞 "Hey Claude, refactor the auth module and call me when you're done or need a decision."

[20 minutes later, phone rings]

🤖 "I've finished the refactor but found a security issue. Should I fix it now or create a ticket?"

💬 Or via SMS/WhatsApp:

You: "Claude, how's the deployment going?"

Claude: "Deployment complete. 3 services updated, all health checks passing."

Features

• 📱 Inbound calls - Call Claude Code from your phone to start tasks
• 📲 Outbound calls - Claude calls you when done, stuck, or needs decisions
• 💬 SMS messaging - Send and receive text messages with Claude
• 📱 WhatsApp - Full WhatsApp Business integration
• 🔄 Cross-channel context - Start on voice, continue on WhatsApp seamlessly
• 🔗 Persistent sessions - Claude stays alive listening for WhatsApp messages
• 🔒 Secure transport - Tailscale Funnel with guided auto-setup
• 🗣️ Natural conversations - Multi-turn interactions across all channels
• 🔧 Tool composable - Claude can use other tools while communicating
• ⚡ Auto-webhook updates - Twilio webhooks auto-update when URL changes
• 🆓 Free WhatsApp via Baileys - Personal WhatsApp with zero API costs, no business verification
• ⌚ Works anywhere - Phone, smartwatch, or any device

⚠️ Testing Status

Channel	Provider	Status
Voice	Twilio	✅ Tested & Working
WhatsApp	Twilio Sandbox	✅ Tested & Working
SMS	Twilio	⏳ Pending A2P 10DLC verification
Voice	Telnyx	🔬 Not yet tested
SMS	Telnyx	🔬 Not yet tested
WhatsApp	Telnyx	🔬 Not yet tested
WhatsApp	Baileys (free)	🔬 New - testing welcome

Contributions welcome for testing other provider/channel combinations!

Quick Start

1. Choose Your Setup

Just want WhatsApp? Skip to Option C: Baileys — no accounts, no API keys, completely free.

2. Set Up Phone Provider

git clone https://github.com/sns45/better-call-claude
cd better-call-claude
bun install

bun run baileys:pair

{
  "mcpServers": {
    "better-call-claude": {
      "command": "bun",
      "args": ["run", "/path/to/better-call-claude/src/index.ts"],
      "env": {
        "BETTERCALLCLAUDE_WHATSAPP_PROVIDER": "baileys",
        "BETTERCALLCLAUDE_USER_PHONE_NUMBER": "+1234567890"
      }
    }
  }
}

{
  "env": {
    "BETTERCALLCLAUDE_PHONE_PROVIDER": "twilio",
    "BETTERCALLCLAUDE_WHATSAPP_PROVIDER": "baileys",
    "BETTERCALLCLAUDE_PHONE_ACCOUNT_SID": "your-account-sid",
    "BETTERCALLCLAUDE_PHONE_AUTH_TOKEN": "your-auth-token",
    "BETTERCALLCLAUDE_PHONE_NUMBER": "+15551234567",
    "BETTERCALLCLAUDE_USER_PHONE_NUMBER": "+15559876543",
    "BETTERCALLCLAUDE_OPENAI_API_KEY": "sk-..."
  }
}

3. Set Up Tailscale Funnel (for webhooks)

Skip this step if you're using Baileys-only mode (Option C). Baileys doesn't need webhooks.

Tailscale Funnel provides free, stable public URLs for receiving webhooks from your phone provider.

Why Tailscale? Free unlimited tunnels, stable URLs (no random subdomains), enterprise-grade security.

Path: Better Call Claude uses /bcc path (e.g., https://your-hostname.ts.net/bcc) to avoid conflicts with other services.

First-time setup (automated):

When you first start the MCP server, it will guide you through setup:

1. Install Tailscale (if not installed):

   bash

   Copy

   # macOS
   brew install tailscale
   
   # Linux
   curl -fsSL https://tailscale.com/install.sh | sh
   

2. Authenticate - The server will auto-run tailscale up and open your browser

3. Enable Funnel - Visit the URL shown in the terminal to enable Funnel on your tailnet (one-time admin step)

That's it! The server handles the rest automatically.

4. Install Better Call Claude

# Quick start with bunx (recommended)
bunx better-call-claude

# Or install globally
bun install -g better-call-claude
better-call-claude

5. Add to Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "better-call-claude": {
      "command": "bunx",
      "args": ["better-call-claude"],
      "env": {
        "BETTERCALLCLAUDE_PHONE_PROVIDER": "telnyx",
        "BETTERCALLCLAUDE_PHONE_ACCOUNT_SID": "your-connection-id",
        "BETTERCALLCLAUDE_PHONE_AUTH_TOKEN": "your-api-key",
        "BETTERCALLCLAUDE_PHONE_NUMBER": "+15551234567",
        "BETTERCALLCLAUDE_USER_PHONE_NUMBER": "+15559876543",
        "BETTERCALLCLAUDE_OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Note: Tailscale setup is automatic on first run. The server will guide you through installation and authentication if needed.

Restart Claude Code. Done!

Environment Variables

Required Variables

Baileys (Free WhatsApp)

Baileys-only mode: When WHATSAPP_PROVIDER=baileys and no Twilio/Telnyx credentials are set, only USER_PHONE_NUMBER is required. No Tailscale, no OpenAI key needed.

Tailscale (Optional)