Callwright
Self-hosted MCP voice agent that places phone calls on your behalf via Retell.
- Pricing
- Open source
- Runs
- Remotely
- Version
- 1.0.4
- Listing updated
- 5 days ago
About Callwright
Callwright is an open-source MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add callwright --env RETELL_API_KEY='<RETELL_API_KEY>' --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' --env CLAUDE_ROUTINE_TOKEN='<CLAUDE_ROUTINE_TOKEN>' -- npx -y callwrightAdd to claude_desktop_config.json
{
"mcpServers": {
"callwright": {
"command": "npx",
"args": [
"-y",
"callwright"
],
"env": {
"RETELL_API_KEY": "<RETELL_API_KEY>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>",
"CLAUDE_ROUTINE_TOKEN": "<CLAUDE_ROUTINE_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"callwright": {
"command": "npx",
"args": [
"-y",
"callwright"
],
"env": {
"RETELL_API_KEY": "<RETELL_API_KEY>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>",
"CLAUDE_ROUTINE_TOKEN": "<CLAUDE_ROUTINE_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"callwright": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"callwright"
],
"env": {
"RETELL_API_KEY": "<RETELL_API_KEY>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>",
"CLAUDE_ROUTINE_TOKEN": "<CLAUDE_ROUTINE_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"callwright": {
"command": "npx",
"args": [
"-y",
"callwright"
],
"env": {
"RETELL_API_KEY": "<RETELL_API_KEY>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>",
"CLAUDE_ROUTINE_TOKEN": "<CLAUDE_ROUTINE_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"callwright": {
"command": "npx",
"args": [
"-y",
"callwright"
],
"env": {
"RETELL_API_KEY": "<RETELL_API_KEY>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>",
"CLAUDE_ROUTINE_TOKEN": "<CLAUDE_ROUTINE_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
RETELL_API_KEYYour Retell secret API key (stays server-side)RequiredMCP_AUTH_TOKENBearer token clients must send; required when exposed beyond localhostPORTPort the HTTP MCP server listens on (default 8787)CALLWRIGHT_DATA_DIRPersistent directory for runtime state such as trigger deduplicationCALLWRIGHT_PUBLIC_URLPublic Callwright base URL used to configure Retell webhook deliveryCLAUDE_ROUTINE_URLOptional complete Claude cloud Routine /fire endpoint URLCLAUDE_ROUTINE_TOKENOptional dedicated bearer token for the configured Claude Routine trigger
Pricing
Open source
Callwright FAQ
Is Callwright free?
Yes. Callwright is open source, so you can use and self-host it for free.
How do I add Callwright to Claude Code?
Run this command in your terminal: claude mcp add callwright --env RETELL_API_KEY='<RETELL_API_KEY>' --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' --env CLAUDE_ROUTINE_TOKEN='<CLAUDE_ROUTINE_TOKEN>' -- npx -y callwright
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.