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?

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)

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

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

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

This is a Model Context Protocol (MCP) server for WhatsApp, built with TypeScript and using the `@whiskeysockets/baileys` library. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.