omnidim-mcp-server — Claude Code MCP server: how to install
Connects AI coding assistants to OmniDimension to configure voice bots, manage phone lines, and dispatch outbound calls. Requires an API key.
claude mcp add --transport http omnidim-mcp-server https://mcp.omnidim.io/mcpWhat omnidim-mcp-server does
This server connects coding assistants to the OmniDimension telephony infrastructure. It exposes tools to assemble and modify voice agents, bind knowledge bases, and upload reference documents. The integration also handles telephone numbers from Twilio, Exotel, or SIP connections, alongside listings for speech synthesis, recognition engines, and language models.
OmniDimension offers both a local stdio package via @omnidim-ai/mcp-server and a hosted endpoint at https://mcp.omnidim.io/mcp. Local execution demands an OMNIDIM_API_KEY set in the environment or stored under ~/.config/omnidim/credentials. Without this key, requests fail authentication immediately.
A built-in diagnostic utility, invoked via doctor, reports connectivity status without printing secret tokens. Local error records remain stored on your machine in ~/.config/omnidim/logs/mcp.log.
What it helps with
- trigger single outbound phone calls or bulk outreach operations
- set up voice assistants and link documentation to their knowledge base
- import phone lines through SIP, Twilio, or Exotel
- query supported speech-to-text engines and synthetic voice options
Example prompts for the agent
- Build a customer support voice agent and bind
company_faq.pdfto its knowledge base. - Dispatch a verification call to +1987654321 using the imported SIP line.
- List active bulk call campaigns and retrieve status logs for recent batches.
How to install omnidim-mcp-server
1Platform CLI: remote server
claude mcp add --transport http omnidim-mcp-server https://mcp.omnidim.io/mcp2Platform CLI
claude mcp add --env OMNIDIM_API_KEY=<OMNIDIM_API_KEY> --transport stdio omnidim-mcp-server -- npx -y @omnidim-ai/mcp-serverReplace <…> with your own values
1Platform CLI: remote server
codex mcp add omnidim-mcp-server --url https://mcp.omnidim.io/mcp2Platform CLI
codex mcp add omnidim-mcp-server --env OMNIDIM_API_KEY=<OMNIDIM_API_KEY> -- npx -y @omnidim-ai/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"omnidim-mcp-server": {
"url": "https://mcp.omnidim.io/mcp"
}
}
}{
"mcpServers": {
"omnidim-mcp-server": {
"command": "npx",
"args": [
"-y",
"@omnidim-ai/mcp-server"
],
"env": {
"OMNIDIM_API_KEY": "<OMNIDIM_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"omnidim-mcp-server": {
"type": "http",
"url": "https://mcp.omnidim.io/mcp"
}
}
}{
"servers": {
"omnidim-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@omnidim-ai/mcp-server"
],
"env": {
"OMNIDIM_API_KEY": "<OMNIDIM_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http omnidim-mcp-server https://mcp.omnidim.io/mcp2Platform CLI
gemini mcp add -e OMNIDIM_API_KEY=<OMNIDIM_API_KEY> omnidim-mcp-server npx -y @omnidim-ai/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about omnidim-mcp-server
How do I install omnidim-mcp-server in Claude Code?
Run claude mcp add --transport http omnidim-mcp-server https://mcp.omnidim.io/mcp in your terminal.
What does omnidim-mcp-server do?
It enables assistants to control OmniDimension voice agents, manage phone trunks, upload documents to knowledge stores, and initiate calls directly from editor sessions.
Where does the server look for authentication credentials?
When running locally, it reads the OMNIDIM_API_KEY environment variable or checks ~/.config/omnidim/credentials. Keys can be generated in the omnidim.io/api-management console.
