chatterbox_mcp_server

Ruandv/chatterbox_mcp_server

3.1
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 dayong@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 ā†’
slack-mcp-server

slack-mcp-server

4.8

by korotovsky

The Slack MCP Server is a Model Context Protocol server designed for Slack Workspaces, supporting Stdio and SSE transports without requiring permissions or bot creation.

communication
reddit-mcp

reddit-mcp

4.6

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
mcp-hfspace

mcp-hfspace

4.5

by evalstate

mcp-hfspace MCP Server connects to Hugging Face Spaces with minimal setup, providing Image Generation capabilities to Claude Desktop.

ai_chatbot
mcp-server-chatsum

mcp-server-chatsum

4.5

by chatmcp

This MCP Server is used to summarize your chat messages.

communication
graphlit-mcp-server

graphlit-mcp-server

4.5

by graphlit

The Model Context Protocol (MCP) Server for the Graphlit Platform facilitates integration between MCP clients and the Graphlit service, enabling seamless ingestion, search, and retrieval of knowledge across various platforms.

knowledge_and_memory
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.4

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
sentry-mcp

sentry-mcp

4.4

by getsentry

Sentry-MCP is a prototype remote MCP server acting as middleware to the upstream Sentry API provider.

communication
osp_marketing_tools

osp_marketing_tools

4.3

by open-strategy-partners

A comprehensive suite of tools for technical marketing content creation, optimization, and product positioning based on Open Strategy Partners' proven methodologies.

communication
mcp-compass

mcp-compass

4.3

by liuyoshio

MCP Compass is a discovery and recommendation service for exploring Model Context Protocol servers using natural language queries.

research_and_data
mcp-hotnews-server

mcp-hotnews-server

4.2

by wopal-cn

A Model Context Protocol (MCP) server that provides real-time hot trending topics from major Chinese social platforms and news sites.

entertainment_and_media
mcp-server-asana

mcp-server-asana

4.2

by roychri

This Model Context Protocol server implementation of Asana allows you to interact with the Asana API from MCP Clients such as Anthropic's Claude Desktop Application.

developer_tools
python-mcp-server-client

python-mcp-server-client

4.1

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
mcp-perplexity

mcp-perplexity

4.1

by daniel-lxs

The Perplexity MCP Server provides a Python-based interface to the Perplexity API, offering tools for querying responses, maintaining chat history, and managing conversations.

communication
algorand-mcp

algorand-mcp

4.0

by GoPlausible

This is a Model Context Protocol (MCP) implementation for Algorand blockchain interactions, providing a server package for blockchain interactions and a client package for wallet management and transaction signing.

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
claude-prompts-mcp

claude-prompts-mcp

3.9

by minipuft

Claude Prompts MCP Server is a universal Model Context Protocol server designed to enhance AI workflows with advanced prompt engineering and orchestration capabilities.

ai_chatbot
tiktok-mcp

tiktok-mcp

3.9

by Seym0n

The TikTok MCP integrates TikTok access into Claude AI and other apps via TikNeuron.

ai_chatbot
apple-mcp

apple-mcp

3.8

by supermemoryai

This is a collection of Apple-native tools for the Model Context Protocol (MCP) that integrates with various Apple applications to automate tasks and manage communications.

os_automation
iMCP

iMCP

3.7

by mattt

iMCP is a macOS app designed to integrate AI with your digital life, utilizing the Model Context Protocol (MCP) to connect with various clients.

calendar_management
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
gitlab-mcp

gitlab-mcp

3.7

by zereight

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

developer_tools
Aspire.MCP.Sample

Aspire.MCP.Sample

3.7

by elbruno

Sample MCP Server and MCP client using Aspire.

communication
telegram-mcp

telegram-mcp

3.7

by chigwell

Telegram MCP Server is a full-featured integration for Telegram, allowing programmatic interaction with Telegram accounts using the Model Context Protocol (MCP).

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
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