← Index

io.github.sns45/better-call-claude

io.github.sns45/better-call-claude·v3.1.1·Chat & Messaging
Quality Score
83
/100

Voice Calls, SMS, and WhatsApp for Claude Code with cross-channel context sharing.

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "better-call-claude": {
      "command": "npx",
      "args": [
        "-y",
        "better-call-claude"
      ],
      "env": {
        "BETTERCALLCLAUDE_PHONE_PROVIDER": "<bettercallclaude_phone_provider>",
        "BETTERCALLCLAUDE_PHONE_NUMBER": "<bettercallclaude_phone_number>",
        "BETTERCALLCLAUDE_PHONE_ACCOUNT_SID": "<your-bettercallclaude_phone_account_sid>",
        "BETTERCALLCLAUDE_PHONE_AUTH_TOKEN": "<your-bettercallclaude_phone_auth_token>",
        "BETTERCALLCLAUDE_USER_PHONE_NUMBER": "<bettercallclaude_user_phone_number>",
        "BETTERCALLCLAUDE_OPENAI_API_KEY": "<your-bettercallclaude_openai_api_key>",
        "BETTERCALLCLAUDE_WHATSAPP_NUMBER": "<bettercallclaude_whatsapp_number>",
        "BETTERCALLCLAUDE_PORT": "<bettercallclaude_port>",
        "TAILSCALE_HOSTNAME": "<tailscale_hostname>",
        "BETTERCALLCLAUDE_WHATSAPP_PROVIDER": "<bettercallclaude_whatsapp_provider>",
        "BETTERCALLCLAUDE_BAILEYS_AUTH_DIR": "<bettercallclaude_baileys_auth_dir>",
        "BETTERCALLCLAUDE_WHATSAPP_CHAT_HISTORY_SIZE": "<bettercallclaude_whatsapp_chat_history_size>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "better-call-claude": {
      "command": "npx",
      "args": [
        "-y",
        "better-call-claude"
      ],
      "env": {
        "BETTERCALLCLAUDE_PHONE_PROVIDER": "<bettercallclaude_phone_provider>",
        "BETTERCALLCLAUDE_PHONE_NUMBER": "<bettercallclaude_phone_number>",
        "BETTERCALLCLAUDE_PHONE_ACCOUNT_SID": "<your-bettercallclaude_phone_account_sid>",
        "BETTERCALLCLAUDE_PHONE_AUTH_TOKEN": "<your-bettercallclaude_phone_auth_token>",
        "BETTERCALLCLAUDE_USER_PHONE_NUMBER": "<bettercallclaude_user_phone_number>",
        "BETTERCALLCLAUDE_OPENAI_API_KEY": "<your-bettercallclaude_openai_api_key>",
        "BETTERCALLCLAUDE_WHATSAPP_NUMBER": "<bettercallclaude_whatsapp_number>",
        "BETTERCALLCLAUDE_PORT": "<bettercallclaude_port>",
        "TAILSCALE_HOSTNAME": "<tailscale_hostname>",
        "BETTERCALLCLAUDE_WHATSAPP_PROVIDER": "<bettercallclaude_whatsapp_provider>",
        "BETTERCALLCLAUDE_BAILEYS_AUTH_DIR": "<bettercallclaude_baileys_auth_dir>",
        "BETTERCALLCLAUDE_WHATSAPP_CHAT_HISTORY_SIZE": "<bettercallclaude_whatsapp_chat_history_size>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y better-call-claude
§02  Environment variables
BETTERCALLCLAUDE_PHONE_PROVIDER
required

Phone provider: 'twilio' or 'telnyx'

BETTERCALLCLAUDE_PHONE_NUMBER
required

Your phone number in E.164 format

BETTERCALLCLAUDE_PHONE_ACCOUNT_SID
requiredsecret

Twilio Account SID or Telnyx API Key

BETTERCALLCLAUDE_PHONE_AUTH_TOKEN
requiredsecret

Twilio Auth Token or Telnyx API Secret

BETTERCALLCLAUDE_USER_PHONE_NUMBER
required

Your personal phone number in E.164 format (for outbound calls/SMS)

BETTERCALLCLAUDE_OPENAI_API_KEY
requiredsecret

OpenAI API key for speech-to-text (Whisper) and text-to-speech

BETTERCALLCLAUDE_WHATSAPP_NUMBER

WhatsApp number if different from phone number (e.g., Twilio Sandbox)

BETTERCALLCLAUDE_PORT

Local HTTP server port

TAILSCALE_HOSTNAME

Override Tailscale hostname for webhook URL

BETTERCALLCLAUDE_WHATSAPP_PROVIDER

WhatsApp provider: set to 'baileys' for free WhatsApp via WebSocket (no Twilio needed)

BETTERCALLCLAUDE_BAILEYS_AUTH_DIR

Path to Baileys auth state directory (default: data/baileys-auth)

BETTERCALLCLAUDE_WHATSAPP_CHAT_HISTORY_SIZE

Max WhatsApp chat history messages to retain (default: 50)

§03  MCP Quality Score  ·  methodology
freshness
23
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Chat & Messaging