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.

コメント

「コミュニケーション」の他のコンテンツ