MCP.so
Sign In

WhatsApp MCP Server (TypeScript/Baileys)

@jlucaso1

Repository

About WhatsApp MCP Server (TypeScript/Baileys)

WhatsApp MCP Server (TypeScript/Baileys)

#nodejs#typescript#ai#mcp#whatsapp#claude

Basic information

Category

Communication

Runtime

node

Transports

stdio

Publisher

jlucaso1

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "whatsapp-mcp-ts": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@jlucaso1/whatsapp-mcp-ts",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is WhatsApp MCP Server (TypeScript/Baileys)?

This is an MCP server that connects your personal WhatsApp account to an AI agent. Built with TypeScript and the @whiskeysockets/baileys library, it allows the agent to search messages, contacts, list chats, retrieve chat history, and send messages using the WhatsApp Web multi-device API.

How to use WhatsApp MCP Server (TypeScript/Baileys)?

Clone the repository, install dependencies (npm install), and run node src/main.ts to generate a QR code. Scan it with your WhatsApp mobile app to authenticate. Then configure your AI client (e.g., Claude Desktop or Cursor) with a JSON config pointing to the server's main script. Restart the client to use the server's tools.

Key features of WhatsApp MCP Server (TypeScript/Baileys)

  • Search contacts by name or phone number.
  • Retrieve message history with pagination.
  • List chats, sortable and filterable.
  • Get detailed information about a specific chat.
  • Send text messages to individuals or groups.
  • All data stored locally in SQLite and auth cache.

Use cases of WhatsApp MCP Server (TypeScript/Baileys)

  • Ask an AI agent to find a conversation and summarize it.
  • Automatically send reminders or messages to contacts without switching apps.
  • Analyze chat history for patterns or insights.
  • Search for a specific contact or message from your personal WhatsApp.
  • Manage group messages through an AI-powered interface.

FAQ from WhatsApp MCP Server (TypeScript/Baileys)

How does the server connect to my WhatsApp?

It uses the WhatsApp Web multi-device API via the Baileys library. The first run generates a QR code that you scan with your WhatsApp mobile app (Settings > Linked Devices > Link a Device). Authentication credentials are saved locally.

Where is my data stored?

All messages and authentication data are stored locally in your filesystem: authentication info in ./auth_info/ and message history in ./data/whatsapp.db (SQLite). Data is only sent to the AI agent when a tool is explicitly used.

What are the system requirements?

Node.js version 23.10.0 or higher (as specified in package.json). npm is included with Node.js. The server is tested with Anthropic Claude Desktop, Cursor, Cline, or other MCP-compatible clients.

How do I troubleshoot authentication failures?

If the connection logs out (DisconnectReason.loggedOut), stop the server, delete the ./auth_info/ directory, and restart node src/main.ts to get a new QR code. For sync issues, delete both ./auth_info/ and ./data/ directories for a full reset.

What tools does the server expose to the AI agent?

The server provides six MCP tools: search_contacts, list_messages, list_chats, get_chat, get_message_context, and send_message. Each tool is available through the connected AI client's interface.

Comments

More Communication MCP servers

Slack

modelcontextprotocol

Model Context Protocol Servers

88.1K

Twilio MCP Monorepo

twilio-labs

Monorepo providing 1) OpenAPI to MCP Tool generator 2) Exposing all of Twilio's API as MCP Tools

108

PhonePi MCP: Turn your phone into a toolbox for AI assistants using Model Context Protocol

priyankark

PhonePi MCP enables seamless integration between desktop AI tools and your smartphone, providing 23+ direct actions including SMS messaging, phone calls, contact management, snippet creation and search, clipboard sharing, notifications, battery status checks, and remote device co

35

Discord Mcp

SaseQ

A MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automation capabilities.

387

MCP Email Server

Shy2593666979

一个基于 MCP (Model Context Protocol) 的邮件服务，支持 LLM 发送带附件的电子邮件及在指定目录中搜索文件。提供安全的 SMTP 传输、多收件人支持和附件模式匹配搜索功能，适用于 Gmail、Outlook、Yahoo、QQ 邮箱和网易 126 邮箱等主流邮箱服务。

78