これは、WhatsApp用のモデルコンテキストプロトコル(MCP)サーバーで、TypeScriptで構築され、@whiskeysockets/baileysライブラリを使用します。

パーソナルなWhatsAppアカウントをAIエージェント(デスクトップアプリやCursor経由のAnthropic Claudeのような)に接続すると、次の操作が可能になります。

• 個人的なWhatsAppメッセージを検索します。 *連絡先(個人ではなくグループ)を検索します。
• 最近のチャットのリスト。 *特定のチャットのメッセージ履歴を取得します。 *個人や団体にメッセージを送る

WhatsApp WebマルチデバイスAPIを使用して、個人WhatsAppアカウントに直接接続します。 すべてのメッセージと認証情報は、SQLiteデータベース([[./data/]])と認証キャッシュ([./auth_info/]])でlocallyに保存されます。 データは、提供されたMCPツールを明示的に使用したときに接続されたAIエージェントにのみ送信されます(エージェントのインターフェイスを介して制御する)。

(オプション:参考例に類似したスクリーンショットやGIFを追加してください)

例

ユーザー: whatsapp に “Meu amor” に “Te amo” というメッセージを送る

お問い合わせ

保証人: まずは連絡先を見つける必要があります。 工具の使用:[whatsapp.search_contacts

お問い合わせ

ツール結果:

お問い合わせ

保証人:

WhatsApp MCP Server (TypeScript/Baileys)

This is a Model Context Protocol (MCP) server for WhatsApp, built with TypeScript and using the @whiskeysockets/baileys library.

It allows you to connect your personal WhatsApp account to an AI agent (like Anthropic Claude via its desktop app or Cursor) enabling it to:

• Search your personal WhatsApp messages.
• Search your contacts (individuals, not groups).
• List your recent chats.
• Retrieve message history for specific chats.
• Send messages to individuals or groups.

It connects directly to your personal WhatsApp account using the WhatsApp Web multi-device API. All your messages and authentication details are stored locally in a SQLite database (./data/) and authentication cache (./auth_info/). Data is only sent to the connected AI agent when it explicitly uses the provided MCP tools (which you control via the agent’s interface).

(Optional: Consider adding a screenshot or GIF similar to the reference example here)

Example

User: Send a whatsapp message to “Meu amor” in whatsapp saying “Te amo”

---

Assistant: Okay, I need to find the contact first. Using tool: whatsapp.search_contacts

{
  "query": "Meu amor"
}

---

Tool Result:

[
  {
    "jid": "[email protected]",
    "name": "Meu Amor"
  }
]

---

Assistant: Found the contact. Now sending the message. Using tool: whatsapp.send_message

{
  "recipient": "[email protected]",
  "message": "Te amo"
}

---

Tool Result:

Message sent successfully to [email protected] (ID: XXXXXXXXXXX).

Key Features (MCP Tools)

The server exposes the following tools to the connected AI agent:

• search_contacts: Search for contacts by name or phone number part (JID).
• list_messages: Retrieve message history for a specific chat, with pagination.
• list_chats: List your chats, sortable by activity or name, filterable, paginated, optionally includes last message details.
• get_chat: Get detailed information about a specific chat.
• get_message_context: Retrieve messages sent immediately before and after a specific message ID for context.
• send_message: Send a text message to a specified recipient JID (user or group).

Installation

Installing via Smithery

To install WhatsApp MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jlucaso1/whatsapp-mcp-ts --client claude

Prerequisites

• Node.js: Version 23.10.0 or higher (as specified in package.json). You can check your version with node -v. (Has initial typescript and sqlite builtin support)
• npm (or yarn/pnpm): Usually comes with Node.js.