MCP.so
登录

WhatsApp MCP Server (TypeScript/Baileys)

@jlucaso1

基本信息

分类

沟通协作

传输方式

stdio

作者

jlucaso1

关于 WhatsApp MCP Server

WhatsApp MCP Server (TypeScript/Baileys)

WhatsApp MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

WhatsApp MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

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.

常见问题

1

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.

2

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.

3

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.

4

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.

5

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.

评论

沟通协作 分类下的更多 MCP 服务器