RetellAI MCP Server
About
Interact with RetellAI's voice services to create conversational voice AI.
Details
- Author
- abhaybabbar
- GitHub stars
- 39
- Downloads
- 362
- Categories
- Communication, AI, Other
Jump to
- Call management: create, list, get, delete calls
- Agent management: create, list, get, update, delete agents
- Phone number management: provision, configure, list, delete numbers
- Voice management: list and get available voice options
- Supports both phone calls and web calls
- Integrates with Claude Desktop via MCP
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
Add a configuration block to your Claude Desktop claude_desktop_config.json with the command npx -y @abhaybabbar/retellai-mcp-server and set the environment variable RETELL_API_KEY. Alternatively, run the server from source: install dependencies (npm i), create a .env file with your API key, and execute node src/retell/index.js.
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>"
}
}
}RetellAI MCP Server
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.
