Omnichannel MCP Server for Claude Code
Connect Claude Code to ChatbotX via MCP. Manage customer contacts, tags, and chatbot flows across your connected customer channels.
Please make sure there is always a human in the loop.
Connect ChatbotX MCP to Claude Code
Connect ChatbotX MCP in seconds using the Claude Code terminal command, or add it manually to your settings file.
// Add to your Claude Code settings (~/.claude/settings.json)
{
"mcpServers": {
"chatbotx": {
"url": "https://app.chatbotx.io/mcp/sse",
"headers": {
"x-workspace-token": "YOUR_WORKSPACE_TOKEN"
}
}
}
}Claude Code reads this page and wires up the MCP. You approve the connection.
It fetches this page, runs the MCP add command, and stops for you to approve the connection.
# Omnichannel MCP Server for Claude Code Connect Claude Code to ChatbotX via MCP. Manage customer contacts, tags, and chatbot flows across your connected customer channels. - MCP Endpoint: https://app.chatbotx.io/mcp/sse (Server-Sent Events, Workspace Token auth) - Documentation: [ChatbotX MCP Docs](https://chatbotx.io/docs/mcp/introduction) - Web Application: [Get Free Workspace - Start for $0](https://app.chatbotx.io) - Notice: Please make sure there is always a human in the loop. ## Connect ChatbotX MCP to Claude Code Add ChatbotX as an MCP server with one command: ```bash # Add ChatbotX MCP server to Claude Code claude mcp add chatbotx -t sse -H "x-workspace-token: YOUR_WORKSPACE_TOKEN" -s user https://app.chatbotx.io/mcp/sse # Verify the connection claude /mcp # Authenticates via Workspace Token (Settings -> Integrations -> Workspace token) # All tools are available immediately after connection. ``` ## Available MCP Tools Once connected, Claude Code has access to these tools: - contacts_search: Look up contacts by email, phone, or name - contacts_tag: Add or remove segmentation tags on contacts - contacts_custom_field: Update custom fields on contact records - flows_trigger: Trigger automated chatbot flows on specific contacts - conversations_list: List open conversations across all channels - messages_send: Send messages to contacts on any connected channel - broadcasts_list: List and inspect broadcast campaigns - channels_list: List connected messaging channels and their status ## Built for Automation Engineered for autonomous agents and MCP tool pipelines: - MCP Native: Every tool returns structured JSON. Designed for LLMs, function calling, and autonomous agent loops. - Omnichannel Messaging: Manage Instagram, Facebook, TikTok, WhatsApp, Telegram, Zalo OA, Live WebChat, SMS Gateway, and Email from a single MCP server. - Contact CRM & Resolvers: Resolve, create, and update contacts seamlessly by email, phone, or workspace ID. - Tags & Custom Fields: Dynamically tag contacts, query custom attributes, and maintain CRM state. - Chatbot Flows: Trigger interactive multi-step chatbot flows and drip sequences programmatically. - Broadcasts & Inbox: Monitor live conversations, list broadcast audiences, and dispatch campaigns. ## Supported Channels & Runtimes - Channels: Instagram, Facebook, TikTok, WhatsApp, Telegram, Zalo OA, Live WebChat, SMS Gateway, Email (SMTP). - Runtimes: OpenClaw, Claude Code, Hermes, OpenAI Codex, Perplexity, NanoClaw, Paperclip, Antigravity.
Built for Automation
Engineered specifically for autonomous agents, background workers, and terminal execution pipelines.
AI Agent & MCP Ready
Every command returns structured JSON. Designed for LLMs, function calling, and MCP tools with zero token cost overhead.
Omnichannel Messaging
Manage WhatsApp, Telegram, Messenger, Zalo, Instagram, SMS, and WebChat from a single unified command-line tool.
Contact CRM & Resolvers
Resolve, create, and update contacts seamlessly by email, international phone number (+84...), or internal workspace identifier.
Tags & Custom Fields
Dynamically tag contacts, query custom attributes, and maintain synchronized CRM state directly through automation scripts.
Chatbot Flows & Sequences
Trigger interactive multi-step chatbot flows, auto-reply rules, and drip sequences programmatically based on agent logic.
Broadcasts & Inbox Triage
Monitor live open conversations, list target broadcast audiences, and dispatch bulk campaigns with full delivery audit logs.
How It Works
Simple three-step cycle for autonomous discovery, contact execution, and inbox triage.
Discover Workspace
List connected messaging channels, tags, and custom fields to introspect workspace configuration.
chatbotx channels list
# Query tags and fields
chatbotx tags list
chatbotx custom-fields listContacts & Flows
Resolve contact details by email or phone, attach segmentation tags, and launch automated chatbot flows.
# Resolve contact and tag
chatbotx contacts get email:[email protected]
chatbotx contacts tag add email:[email protected] --tagIds tag_vip
# Trigger automated flow
chatbotx contacts flow add email:[email protected] --flowId flow_welcomeInbox & Broadcasts
Monitor open customer conversations across channels, inspect broadcasts, and manage multi-channel dispatches.
# List active unassigned conversations
chatbotx conversations list --status unassigned
# Inspect broadcasts
chatbotx broadcasts listOne Command, Every Channel
Sync CRM contacts, add dynamic tags, and trigger multi-channel flows across WhatsApp, Telegram, and Messenger with simple shell scripts.
# 1. Look up contact by phone or email
chatbotx contacts get phone:+84708123123
# 2. Add VIP segmentation tag
chatbotx contacts tag add phone:+84708123123 --tagIds tag_vip_client
# 3. Update customer custom field
chatbotx contacts custom-field add phone:+84708123123 cf_tier --value "Gold"
# 4. Trigger automated welcome flow or send direct notification
chatbotx contacts flow add phone:+84708123123 --flowId flow_spring_promo
chatbotx contacts message send phone:+84708123123 --text "Your VIP status has been activated!"
# 5. Batch-tag segmented leads from a list
for email in [email protected] [email protected] [email protected]; do
chatbotx contacts tag add email:$email --tagIds tag_lead_qualified
doneWhat is Claude Cowork?
Claude Cowork is Anthropic's agentic AI tool for knowledge workers. It runs on your desktop, connects to local files and apps like Google Drive, Gmail, and DocuSign, and completes multi-step tasks autonomously, including managing customer relationships in ChatbotX.
Desktop Native
Claude Cowork runs directly on your desktop, connecting to local files and apps. No complex cloud infrastructure needed to manage customer inquiries and trigger chatbot flows.
App Integrations
Connects to Google Drive, Gmail, CRM spreadsheets, and local databases. Pull customer data from existing tools and sync directly into ChatbotX contacts.
Autonomous CRM Tasks
Claude Cowork completes multi-step workflows independently. Instruct it to resolve customer details, tag VIP accounts, and dispatch onboarding sequences.
How ChatbotX Works with Claude Code
Claude Code connects to ChatbotX via Model Context Protocol (MCP). It executes MCP tools directly from your terminal session to introspect contacts, update CRM attributes, and launch flows autonomously.
Manage Customer Workflows From Terminal
Tell Claude Code what customer action to take: it connects to ChatbotX via MCP, resolves contact identifiers, updates custom fields, and launches flows without you opening a browser.
You: Look up contact [email protected] in ChatbotX, add the 'enterprise-lead' tag, and trigger our onboarding flow.
Claude Code: Calling ChatbotX MCP tools:
1. Tool Call: contacts_search({ identifier: "email:[email protected]" })
Found contact: John Doe (ID: c_88319)
2. Tool Call: contacts_tag({ identifier: "email:[email protected]", tagIds: ["tag_enterprise_lead"] })
3. Tool Call: flows_trigger({ identifier: "email:[email protected]", flowId: "flow_onboarding" })
Enterprise lead tagged and onboarding flow dispatched successfully.Also Works with Codex & OpenClaw
ChatbotX MCP works seamlessly with any AI agent runtime that supports Model Context Protocol.
Codex
OpenAI Code ArchitectureTranslates natural language intent into precise MCP tool calls and automated workflow dispatches across connected messaging channels.
OpenClaw
Skill-Based Agent RuntimeAutonomous personal AI agent that connects to WhatsApp, Telegram, and terminal workflows via MCP tools and automated heartbeats.
Supported Channels & Runtimes
Connect your channels in ChatbotX once, then automate customer conversations to any of them via CLI or agent.