Whatsapp MCP Ts MCP Server

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

Local serverstdioPython

What is the Whatsapp MCP Ts MCP server?

Whatsapp MCP Ts MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. This is a Model Context Protocol (MCP) server for WhatsApp, built with TypeScript and using the @whiskeysockets/baileys library.

What you get

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

What the assistant can call

Once Whatsapp MCP Ts is connected, these are the calls the assistant has available:

  • 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)
  • Prerequisites — The Prerequisites tool exposed by this server
  • Steps — 1. Clone this repository: bash git clone whatsapp-mcp-ts cd whatsapp-mcp-ts

Configuration and credentials

  • 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. * AI Client: Anthropic Claude Desktop app, Cursor, Cline or Roo Code (or another MCP-compatible client).

Setting it up

Installation goes through your MCP client rather than a global install: point it at @smithery/cli on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Choosing this one

This sits in the team communication group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Whatsapp MCP Ts's toolset — search_contacts, list_messages, list_chats and 5 more — is a fair guide to whether it matches your workflow. It is maintained by aukik; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Whatsapp MCP Ts's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the whatsapp mcp ts mcp server does with a few real requests.

Available tools

ToolWhat it does
search_contactsSearch for contacts by name or phone number part (JID).
list_messagesRetrieve message history for a specific chat, with pagination.
list_chatsList your chats, sortable by activity or name, filterable, paginated, optionally includes last message details.
get_chatGet detailed information about a specific chat.
get_message_contextRetrieve messages sent immediately before and after a specific message ID for context.
send_messageSend a text message to a specified recipient JID (user or group).
PrerequisitesThe Prerequisites tool exposed by this server.
Steps1. **Clone this repository:** bash git clone <your-repo-url> whatsapp-mcp-ts cd whatsapp-mcp-ts

How to install the Whatsapp MCP Ts MCP server

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

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • 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. * AI Client: Anthropic Claude Desktop app, Cursor, Cline or Roo Code (or another MCP-compatible client).

Example prompts to try

  • Use Whatsapp MCP Ts to search contacts.
  • Use Whatsapp MCP Ts to list messages.
  • Use Whatsapp MCP Ts to list chats.

Frequently asked questions

It connects Whatsapp MCP Ts to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (search_contacts, list_messages, list_chats, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Whatsapp MCP Ts directly.