Callwright

Official

by topness

Self-hosted MCP voice agent that places phone calls on your behalf via Retell.

Install

Configuration

Environment variables

RETELL_API_KEYrequiredsecret

Your Retell secret API key (stays server-side)

MCP_AUTH_TOKENsecret

Bearer token clients must send; required when exposed beyond localhost

PORT

Port the HTTP MCP server listens on (default 8787)

CALLWRIGHT_DATA_DIR

Persistent directory for runtime state such as trigger deduplication

CALLWRIGHT_PUBLIC_URL

Public Callwright base URL used to configure Retell webhook delivery

CLAUDE_ROUTINE_URL

Optional complete Claude cloud Routine /fire endpoint URL

CLAUDE_ROUTINE_TOKENsecret

Optional dedicated bearer token for the configured Claude Routine trigger

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "callwright": {
      "command": "npx",
      "args": [
        "-y",
        "callwright@1.0.4"
      ],
      "env": {
        "RETELL_API_KEY": "<YOUR_RETELL_API_KEY>",
        "MCP_AUTH_TOKEN": "<YOUR_MCP_AUTH_TOKEN>",
        "PORT": "<YOUR_PORT>",
        "CALLWRIGHT_DATA_DIR": "<YOUR_CALLWRIGHT_DATA_DIR>",
        "CALLWRIGHT_PUBLIC_URL": "<YOUR_CALLWRIGHT_PUBLIC_URL>",
        "CLAUDE_ROUTINE_URL": "<YOUR_CLAUDE_ROUTINE_URL>",
        "CLAUDE_ROUTINE_TOKEN": "<YOUR_CLAUDE_ROUTINE_TOKEN>"
      }
    }
  }
}