1
Add it to Claude Code
claude mcp add -e "OMICALL_USERNAME=${OMICALL_USERNAME}" -e "OMICALL_PASSWORD=${OMICALL_PASSWORD}" -e "OMICALL_DOMAIN=${OMICALL_DOMAIN}" omicall-mcp -- npx omicall-mcpRequired:
OMICALL_USERNAMEOMICALL_PASSWORDOMICALL_DOMAIN2
Make your agent remember this setup
omicall-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Access to over 80 tools for OMICall and OMICRM API management
- Comprehensive call center operations including PBX and hotline management
- Multi-channel communication support for Zalo, Facebook, Telegram, and LiveTalk
- AI-powered text-to-speech audio generation
- Full ticket lifecycle management (CRUD operations)
Tools 6
login_omicall_mcpAuthenticate with OMICall services.search_callsSearch call history with filters.get_call_detailGet call details by transaction ID.click_to_callInitiate outbound call.search_ticketsSearch tickets with date range and keyword.create_ticketCreate a new support ticket.Environment Variables
OMICALL_USERNAMErequiredThe username for OMICall authenticationOMICALL_PASSWORDrequiredThe password for OMICall authenticationOMICALL_DOMAINrequiredThe company domain for OMICallTry it
→Search for all calls made by the support team in the last 24 hours.
→Initiate a click-to-call request to the customer with phone number +84901234567.
→Create a new ticket regarding the recent billing inquiry from the client.
→List all active extensions in the call center and check their current status.
Original README from VIHATTeam/OMICALL-MCP
OMICall MCP Server
MCP server for OMICall / OMICRM APIs.
80+ tools across 9 groups: Auth, Call Center, Ticket, Multi-Channel (Zalo, Facebook, Telegram, LiveTalk), Agent, Notifications, Webhook, Auto Call, and AI.
Quick Start
npx omicall-mcp
Setup per Platform
<details> <summary><strong>Claude Code</strong></summary>Global (all projects):
# 1. Add MCP server
claude mcp add OMICall-mcp --scope user \
-e [email protected] \
-e OMICALL_PASSWORD=your-password \
-e OMICALL_DOMAIN=your-company \
-- npx omicall-mcp
# 2. Auto-approve all tools (no permission prompts)
claude permissions allow "mcp__OMICall-mcp__*"
Persist permissions — add to ~/.claude/settings.json:
{
"permissions": {
"allow": [
"mcp__OMICall-mcp__*"
]
}
}
Per-project — add to .mcp.json:
{
"mcpServers": {
"omicall": {
"command": "npx",
"args": ["omicall-mcp"],
"env": {
"OMICALL_USERNAME": "[email protected]",
"OMICALL_PASSWORD": "your-password",
"OMICALL_DOMAIN": "your-company"
}
}
}
}
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"omicall": {
"command": "npx",
"args": ["omicall-mcp"],
"env": {
"OMICALL_USERNAME": "[email protected]",
"OMICALL_PASSWORD": "your-password",
"OMICALL_DOMAIN": "your-company"
}
}
}
}
Settings > MCP Servers > Add:
{
"omicall": {
"command": "npx",
"args": ["omicall-mcp"],
"env": {
"OMICALL_USERNAME": "[email protected]",
"OMICALL_PASSWORD": "your-password",
"OMICALL_DOMAIN": "your-company"
}
}
}
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"omicall": {
"command": "npx",
"args": ["omicall-mcp"],
"env": {
"OMICALL_USERNAME": "[email protected]",
"OMICALL_PASSWORD": "your-password",
"OMICALL_DOMAIN": "your-company"
}
}
}
}
Add to .vscode/mcp.json:
{
"servers": {
"omicall": {
"command": "npx",
"args": ["omicall-mcp"],
"env": {
"OMICALL_USERNAME": "[email protected]",
"OMICALL_PASSWORD": "your-password",
"OMICALL_DOMAIN": "your-company"
}
}
}
}
Tools (80+)
Auth
| Tool | Description |
|---|---|
login_omicall_mcp |
Authenticate (auto pre_auth → tenant select → login) |
select_tenant |
Select tenant if multiple |
logout |
Logout and clear tokens |
get_balance |
Account balance |
get_service_package |
Enabled modules & usage limits |
Call Center `switchboard`
| Tool | Description |
|---|---|
search_calls |
Search call history with filters |
get_call_detail |
Call details by transaction ID |
update_call |
Add tags/notes |
evaluate_call / list_eval_criteria |
Call evaluation |
click_to_call |
Initiate outbound call |
list_extensions / get_extension / update_extension / update_extension_status |
PBX extensions |
list_hotlines / get_hotline / update_hotline |
Hotline management |
list_groups / create_group / update_group / delete_group |
Ring groups |
add_group_members / remove_group_members |
Group members |
list_ivr / create_ivr / update_ivr / delete_ivr |
IVR menus |
list_scripts / create_script / update_script / delete_script |
Call scripts |
list_audio / generate_tts_audio / delete_audio |
Audio files |
Ticket `ticket`
| Tool | Description |
|---|---|
search_tickets |
Search with date range, keyword |
get_ticket / create_ticket / update_ticket / delete_ticket |
CRUD |
update_ticket_status |
Status change |
| `create_ti |