A Model Context Protocol (MCP) server that provides seamless integration between Claude AI and Exotel's communication APIs for SMS and voice calling services, plus quick audio tools.
Before using the Exotel MCP Server, ensure you have:
If you don't have mcp-remote installed, run:
npm install -g mcp-remote
Verify installation:
npm list -g mcp-remote
To integrate ExotelMCP with Claude, add the following configuration to your Claude desktop settings:
Location: Claude Desktop → Settings → Developer → Edit Config
{
"mcpServers": {
"exotel": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.exotel.com/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "{'token':'YOUR_EXOTEL_TOKEN','from_number':'YOUR_FROM_NUMBER','dlt_temp':'YOUR_DLT_TEMPLATE','dlt_entity':'YOUR_DLT_ENTITY','caller_id':'YOUR_CALLER_ID','api_domain':'https://YOUR_SUB_DOMAIN','account_sid':'YOUR_ACCOUNT_SID','exotel_portal_url':'YOUR_EXOTEL_DASHBOARD_BASE_URL'}"
}
}
}
}
Replace the placeholder values with your actual Exotel credentials:
This token is created by encoding your Exotel API Key and Secret in Base64 format.
Step 1: Get your API credentials from Exotel Dashboard
Step 2: Create the Base64 token
Format: api_key:api_secret (colon-separated)
Example: If your API Key is abc123 and API Secret is xyz789, combine them as: abc123:xyz789
Step 3: Encode to Base64
You can use any of these methods:
Online Tool:
api_key:api_secret stringCommand Line (Mac/Linux):
echo -n "your_api_key:your_api_secret" | base64
Command Line (Windows):
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("your_api_key:your_api_secret"))
Once configured, you can use Claude to interact with Exotel services using natural language commands. Simply describe what you want to do, and Claude will handle the API calls through the MCP server.
Example Commands:
Audio Commands:
Send a single SMS message to a specific phone number with DLT compliance.
Example:
Send an SMS to +919999999999 with message "Hello from Claude!" using DLT template 1107160086208866373 and entity 1101428740000012125
Send the same message to multiple recipients at once.
Example:
Send "Welcome to our service!" to these numbers: +919999999999, +919888888888, +919777777777
Send personalized messages to multiple recipients with different content for each.
Example:
Send personalized messages: "Hello John" to +919999999999 and "Hello Jane" to +919888888888
Initiate a voice call to any phone number using your registered Exotel number.
Example:
Call +919999999999 from my registered number
Bridge two phone numbers in a single call, connecting them together.
Example:
Connect +919999999999 with +919888888888 in a conference call
Connect a phone number to a predefined Exotel call flow or IVR system.
Example:
Connect +919999999999 to call flow app_id 12345
Get real-time delivery status and details for sent SMS messages.
Example:
Check the delivery status of SMS sent to +919999999999
Retrieve call details, duration, and status for voice calls.
Example:
Get call details for calls made to +919999999999
Retrieve bulk call details and history for analysis.
Example:
Get all call details made from +919999999999
Get metadata and information about phone numbers.
Example:
Get information about phone number +919999999999
Quick one-click audio playback and management tools.
Get instant clickable links to play any audio URL in your browser.
Example:
Play audio from https://example.com/song.mp3
Access the web-based audio player interface for full control.
Example:
Open the audio player interface
Get direct download links for any audio file.
Example:
Download audio from https://example.com/song.mp3
The Exotel MCP Server uses secure token-based authentication. All your Exotel credentials are configured in the Claude desktop configuration and are used to authenticate with Exotel's APIs.
All these credentials should be properly formatted and added to your Claude configuration as shown above.