RetellAI MCP Server
About
Interact with RetellAI's voice services to create conversational voice AI.
Explore
The RetellAI MCP server provides tools for:
- Call Management: Create and manage phone calls and web calls
- Agent Management: Create and manage voice agents with different LLM configurations
- Phone Number Management: Provision and configure phone numbers
- Voice Management: Access and use different voice options
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
RetellAI MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Open Claude Desktop and press CMD + , to go to Settings.
2. Click on the Developer tab.
3. Click on the Edit Config button.
4. This will open the claude_desktop_config.json file in your file explorer.
5. Get your Retell API key from the Retell dashboard (<https://dashboard.retellai.com/apiKey>).
6. Add the following to your claude_desktop_config.json file. See here for more details.
7. Restart the Claude Desktop after editing the config file.
{
"mcpServers": {
"retellai-mcp-server": {
"command": "npx",
"args": ["-y", "@abhaybabbar/retellai-mcp-server"],
"env": {
"RETELL_API_KEY": "<your_retellai_token>"
}
}
}
}
1. Install dependencies:
npm i
2. Create a .env file with your RetellAI API key:
RETELL_API_KEY=your_api_key_here
3. Run the server:
node src/retell/index.js
list_calls
Lists all Retell calls
create_phone_call
Creates a new phone call
create_web_call
Creates a new web call
get_call
Gets details of a specific call
delete_call
Deletes a specific call
list_agents
Lists all Retell agents
create_agent
Creates a new Retell agent
get_agent
Gets a Retell agent by ID
update_agent
Updates an existing Retell agent
delete_agent
Deletes a Retell agent
get_agent_versions
Gets all versions of a Retell agent
list_phone_numbers
Lists all Retell phone numbers
create_phone_number
Creates a new phone number
get_phone_number
Gets details of a specific phone number
update_phone_number
Updates a phone number
delete_phone_number
Deletes a phone number
list_voices
Lists all available Retell voices
get_voice
Gets details of a specific voice
If Claude Desktop shows the server but no tools, upgrade to the latest package version:
npx -y @abhaybabbar/retellai-mcp-server@latest
This issue is typically caused by dependency/version mismatch in older installs.
- list_calls: Lists all Retell calls
- create_phone_call: Creates a new phone call
- create_web_call: Creates a new web call
- get_call: Gets details of a specific call
- delete_call: Deletes a specific call
- list_agents: Lists all Retell agents
- create_agent: Creates a new Retell agent
- get_agent: Gets a Retell agent by ID
- update_agent: Updates an existing Retell agent
- delete_agent: Deletes a Retell agent
- get_agent_versions: Gets all versions of a Retell agent
- list_phone_numbers: Lists all Retell phone numbers
- create_phone_number: Creates a new phone number
- get_phone_number: Gets details of a specific phone number
- update_phone_number: Updates a phone number
- delete_phone_number: Deletes a phone number
- list_voices: Lists all available Retell voices
- get_voice: Gets details of a specific voice
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"retellai mcp server": {
"retellai-mcp-server": {
"command": "npx",
"args": [
"-y",
"@abhaybabbar/retellai-mcp-server"
],
"env": {
"RETELL_API_KEY": "<your_retellai_token>"
}
}
}
}
}McpServers
{
"retellai-mcp-server": {
"command": "npx",
"args": [
"-y",
"@abhaybabbar/retellai-mcp-server"
],
"env": {
"RETELL_API_KEY": "<your_retellai_token>"
}
}
}This is a Model Context Protocol (MCP) server implementation for RetellAI, allowing AI assistants to interact with RetellAI's voice services.
Features
The RetellAI MCP server provides tools for:
- Call Management: Create and manage phone calls and web calls
- Agent Management: Create and manage voice agents with different LLM configurations
- Phone Number Management: Provision and configure phone numbers
- Voice Management: Access and use different voice options
Claude Desktop Setup
1. Open Claude Desktop and press CMD + , to go to Settings.
2. Click on the Developer tab.
3. Click on the Edit Config button.
4. This will open the claude_desktop_config.json file in your file explorer.
5. Get your Retell API key from the Retell dashboard (<https://dashboard.retellai.com/apiKey>).
6. Add the following to your claude_desktop_config.json file. See here for more details.
7. Restart the Claude Desktop after editing the config file.
{
"mcpServers": {
"retellai-mcp-server": {
"command": "npx",
"args": ["-y", "@abhaybabbar/retellai-mcp-server"],
"env": {
"RETELL_API_KEY": "<your_retellai_token>"
}
}
}
}
Troubleshooting: "No tools available"
If Claude Desktop shows the server but no tools, upgrade to the latest package version:
npx -y @abhaybabbar/retellai-mcp-server@latest
This issue is typically caused by dependency/version mismatch in older installs.
Example use cases:
1. List all the numbers I have in retellai
2. List all the agents I have
3. Tell me more about pizza delivery agent
4. Creating agent and calling example:
1. Create an agent that calls my local pizza shop, make sure to keep the conversation short and to the point.
2. Order a margeritta pizza
3. Payment will be done by cash on delivery
4. Send it to <address>
5. The agent should pretend to be me. My name is <your_name>
6. Make an outbound call to my local pizza shop at <phone_number>, using the usa number
Repo Setup
1. Install dependencies:
npm i
2. Create a .env file with your RetellAI API key:
RETELL_API_KEY=your_api_key_here
3. Run the server:
node src/retell/index.js
Available Tools
Call Tools
- list_calls: Lists all Retell calls
- create_phone_call: Creates a new phone call
- create_web_call: Creates a new web call
- get_call: Gets details of a specific call
- delete_call: Deletes a specific call
Agent Tools
- list_agents: Lists all Retell agents
- create_agent: Creates a new Retell agent
- get_agent: Gets a Retell agent by ID
- update_agent: Updates an existing Retell agent
- delete_agent: Deletes a Retell agent
- get_agent_versions: Gets all versions of a Retell agent
Phone Number Tools
- list_phone_numbers: Lists all Retell phone numbers
- create_phone_number: Creates a new phone number
- get_phone_number: Gets details of a specific phone number
- update_phone_number: Updates a phone number
- delete_phone_number: Deletes a phone number
Voice Tools
- list_voices: Lists all available Retell voices
- get_voice: Gets details of a specific voice
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
