chatterbox_mcp_server

Ruandv/chatterbox_mcp_server

3.2
communicationai_chatbot

If you are the rightful owner of chatterbox_mcp_server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Chatterbox MCP Server is a Model Context Protocol implementation designed for seamless integration with AI models and tools like WhatsApp.

๐Ÿš€ Chatterbox MCP Server (indexed and certified by )

This repository contains two main components:

๐Ÿค– MCP Server (mcp_server/)

The Model Context Protocol server that provides WhatsApp functionality through MCP tools.

Key files:

  • mcp_server/src/server.ts - Main MCP server
  • mcp_server/src/model/tools.ts - MCP tools for WhatsApp operations
  • mcp_server/src/model/resources.ts - MCP resources

Usage:

cd mcp_server
npm install
npm run dev

๐Ÿ“ฑ WhatsApp Server (whatsappServer/)

The REST API server that handles actual WhatsApp Web integration.

Key files:

  • whatsappServer/src/server.ts - Main Express server
  • whatsappServer/src/services/whatsappService.ts - WhatsApp Web.js integration
  • whatsappServer/src/controllers/whatsappController.ts - API endpoints

Usage:

cd whatsappServer
npm install
npm run dev

๐Ÿ”ง Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    HTTP API    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                 โ”‚    Calls       โ”‚                 โ”‚
โ”‚   MCP Server    โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ โ”‚ WhatsApp Server โ”‚
โ”‚                 โ”‚                โ”‚                 โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜                โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
        โ”‚                                   โ”‚
        โ”‚                                   โ”‚
        โ–ผ                                   โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”                โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  MCP Client     โ”‚                โ”‚  WhatsApp Web   โ”‚
โ”‚  (Claude, etc)  โ”‚                โ”‚                 โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜                โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ“ Project Structure

chatterbox_mcp_server/
โ”œโ”€โ”€ mcp_server/
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ secrets/                    # Secret files for MCP server
โ”‚   โ”‚   โ”œโ”€โ”€ CHATTERBOX_SECRET
โ”‚   โ”‚   โ””โ”€โ”€ WHATSAPP_SERVER_URL
โ”‚   โ””โ”€โ”€ package.json
โ”œโ”€โ”€ whatsappServer/
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ secrets/                    # Secret files for WhatsApp server
โ”‚   โ”‚   โ”œโ”€โ”€ CHATTERBOX_SECRET
โ”‚   โ”‚   โ”œโ”€โ”€ PORT
โ”‚   โ”‚   โ””โ”€โ”€ HEADLESS
โ”‚   โ””โ”€โ”€ package.json
โ””โ”€โ”€ package.json

๐Ÿš€ Quick Start

  1. Set up secrets:

    # MCP Server secrets (in mcp_server/secrets/)
echo "your_secret_here" > mcp_server/secrets/CHATTERBOX_SECRET
echo "http://localhost:3004" > mcp_server/secrets/WHATSAPP_SERVER_URL

# WhatsApp Server secrets (in whatsappServer/secrets/)
echo "your_secret_here" > whatsappServer/secrets/CHATTERBOX_SECRET
echo "3004" > whatsappServer/secrets/PORT
echo "true" > whatsappServer/secrets/HEADLESS

  2. Install dependencies:

    npm run install:all

  3. Start WhatsApp Server:

    npm run dev:whatsapp

  4. Start MCP Server:

    npm run dev:mcp

  5. Authenticate WhatsApp:

    • Visit http://localhost:3004/qr to get QR code
    • Scan with WhatsApp mobile app

๐Ÿ› ๏ธ Development

Each component can be developed independently:

  • MCP Server focuses on MCP protocol implementation
  • WhatsApp Server handles WhatsApp Web integration and API endpoints

๐Ÿ“‹ Required Secrets

Both servers use file-based secrets instead of environment variables for better security. Each secret is stored in a separate file within the secrets/ folder.

MCP Server (mcp_server/secrets/)

  • CHATTERBOX_SECRET - Authentication secret for API calls to WhatsApp server
  • WHATSAPP_SERVER_URL - URL of the WhatsApp server (e.g., http://localhost)
  • SERVER_PORT - Port on which the server is listening on (e.g., 3004)

WhatsApp Server (whatsappServer/secrets/)

  • CHATTERBOX_SECRET - Authentication secret (must match MCP server secret)
  • PORT - Server port number (e.g., 3004)
  • HEADLESS - Run WhatsApp in headless mode (true or false)

Note: The CHATTERBOX_SECRET must be the same in both servers for authentication to work.

๐Ÿณ Docker

Each component has its own Dockerfile for containerization:

# WhatsApp Server
cd whatsappServer
docker build -t whatsapp-server .

# MCP Server
cd mcp_server
docker build -t mcp-server .

Related MCP Servers

View all communication servers โ†’
discord-mcp

discord-mcp

4.4

by SaseQ

A Model Context Protocol (MCP) server for the Discord API, enabling seamless integration of Discord Bot with MCP-compatible applications.

communication
claude-code-mcp

claude-code-mcp

4.4

by auchenberg

Claude Code MCP is an implementation of Claude Code as a Model Context Protocol (MCP) server, enabling its software engineering capabilities through a standardized interface.

developer_tools
mcp

mcp

4.3

by mondaycom

monday.com MCP is an open framework for integrating AI agents with monday.com, providing secure access to structured data and tools for smart decision-making.

cloud_platforms
mcp-server-chatsum

mcp-server-chatsum

4.3

by chatmcp

This MCP Server is used to summarize your chat messages.

communication
discordmcp

discordmcp

4.3

by v-3

A Model Context Protocol (MCP) server that enables LLMs to interact with Discord channels, allowing them to send and read messages through Discord's API.

communication
mcp-atlassian

mcp-atlassian

4.2

by sooperset

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). This integration supports both Confluence & Jira Cloud and Server/Data Center deployments.

cloud_platforms
mcp-linkedin

mcp-linkedin

4.2

by adhikasp

A Model Context Protocol (MCP) server that provides tools to interact with LinkedIn's Feeds and Job API using an unofficial LinkedIn API.

communication
reddit-mcp

reddit-mcp

4.2

by Arindam200

This repository contains a Model Context Protocol server implementation for Reddit that allows AI assistants to access and interact with Reddit content through PRAW (Python Reddit API Wrapper).

communication
gistpad-mcp

gistpad-mcp

4.2

by lostintangent

GistPad MCP is a server for managing and sharing personal knowledge, daily notes, and reusable prompts via GitHub Gists, integrated with VS Code and GistPad.dev.

knowledge_and_memory
python-mcp-server-client

python-mcp-server-client

4.2

by GobinFan

MCP Server is a server implementing the Model Context Protocol (MCP) to provide a standardized interface for AI models, connecting external data sources and tools like file systems, databases, or APIs.

ai_chatbot
fetch-mcp

fetch-mcp

4.1

by egoist

fetch-mcp is an MCP server designed for fetching URLs and Youtube video transcripts, sponsored by ChatWise.

communication
backlog-mcp-server

backlog-mcp-server

4.0

by nulab

A Model Context Protocol (MCP) server for interacting with the Backlog API, providing tools for managing projects, issues, wiki pages, and more through AI agents.

developer_tools
interactive-mcp

interactive-mcp

4.0

by ttommyth

A MCP Server implemented in Node.js/TypeScript, facilitating interactive communication between LLMs and users.

communication
sms-mcp-server

sms-mcp-server

4.0

by YiyangLi

A Model Context Protocol (MCP) server that enables Claude and other AI assistants to send SMS and MMS messages using Twilio.

communication
imessage-query-fastmcp-mcp-server

imessage-query-fastmcp-mcp-server

3.8

by hannesrudolph

An MCP server that provides safe access to your iMessage database through Model Context Protocol (MCP).

communication
Aspire.MCP.Sample

Aspire.MCP.Sample

3.8

by elbruno

Sample MCP Server and MCP client using Aspire.

communication
fastapi_mcp

fastapi_mcp

3.7

by tadata-org

FastAPI-MCP is a tool that allows you to expose your FastAPI endpoints as Model Context Protocol (MCP) tools with built-in authentication.

developer_tools
Inbox Zero AI

Inbox Zero AI

3.7

by elie222

Inbox Zero MCP Server is designed to help users manage their inbox efficiently by integrating with various desktop applications.

communication
twitter-mcp

twitter-mcp

3.7

by EnesCinr

This MCP server allows Clients to interact with Twitter, enabling posting tweets and searching Twitter.

communication
mcp-deepseek-demo

mcp-deepseek-demo

3.7

by Ulanxx

MCP DeepSeek ๆผ”็คบ้กน็›ฎๆ˜ฏไธ€ไธชๅŸบไบŽ Model Context Protocol (MCP) ็š„ๅฎขๆˆท็ซฏๅบ”็”จ๏ผŒ็”จไบŽไธŽ DeepSeek AI ๆจกๅž‹่ฟ›่กŒไบคไบ’ใ€‚

communication
line-bot-mcp-server

line-bot-mcp-server

3.7

by line

LINE Bot MCP Server integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

communication
JotDown

JotDown

3.7

by Harry-027

Jotdown is a Model Context Protocol (MCP) server that allows large language models (LLMs) to interact with Notion and generate Markdown Books.

file_systems
gitlab-mcp

gitlab-mcp

3.7

by zereight

GitLab MCP Server with enhancements and bug fixes over the original version.

developer_tools
linear-mcp-server

linear-mcp-server

3.7

by jerhadf

A Model Context Protocol server for the Linear API, providing integration with Linear's issue tracking system through MCP.

communication
homeassistant-mcp

homeassistant-mcp

3.6

by tevonsb

The server uses the MCP protocol to share access to a local Home Assistant instance with an LLM application.

os_automation
clickup-mcp-server

clickup-mcp-server

3.6

by taazkareem

A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications, allowing AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.

communication
mcp-google-ads

mcp-google-ads

3.6

by cohnen

Google Ads MCP is a tool that integrates Google Ads with Claude AI, enabling users to analyze advertising data through natural language conversations.

ai_chatbot