Skip to main content
Glama
ferazfhansurie

claude-whatsapp-mcp

claude-whatsapp-mcp

WhatsApp MCP server for Claude Code. Read messages, send replies, search contacts — all from your terminal.

Built with whatsapp-web.js and the Model Context Protocol.

What it does

Give Claude Code direct access to your WhatsApp:

  • Read chats — "check my unreads", "what did Ali say?"

  • Send messages — "send John the proposal PDF"

  • Search contacts — "find Sarah's number"

  • Connection management — QR code auth, session persistence

Related MCP server: WhatsApp MCP for macOS

Setup

1. Clone and install

git clone https://github.com/ferazfhansurie/claude-whatsapp-mcp.git
cd claude-whatsapp-mcp
npm install

2. Add to Claude Code

Add this to your Claude Code MCP settings (~/.claude.json or project .mcp.json):

{
  "mcpServers": {
    "whatsapp": {
      "command": "node",
      "args": ["/path/to/claude-whatsapp-mcp/src/index.js"]
    }
  }
}

3. Connect WhatsApp

In Claude Code, just say:

connect to whatsapp

Claude will initialize the server and show you a QR code. Scan it with your phone (WhatsApp > Settings > Linked Devices > Link a Device).

Your session persists in .wwebjs_auth/ — you only need to scan once.

Tools

Tool

Description

whatsapp_connect

Connect to WhatsApp or check status. Shows QR if needed.

whatsapp_send_message

Send text + optional file attachment

whatsapp_list_chats

List recent chats with unread counts

whatsapp_read_chat

Read messages from a specific chat

whatsapp_search_contacts

Search contacts by name or number

whatsapp_status

Connection status + unread summary

Usage examples

# Check unreads
"do I have any unread WhatsApp messages?"

# Read a specific chat
"what's the latest in my family group?"

# Send a message
"send Ali a message saying the meeting is at 3pm"

# Send a file
"send the invoice PDF to +60123456789"

# Search contacts
"find contacts named Sarah"

Requirements

  • Node.js 18+

  • Claude Code with MCP support

  • A WhatsApp account

How it works

The server runs whatsapp-web.js locally on your machine — the same tech as WhatsApp Web. Your messages stay on your device. Nothing is sent to any external server.

On first run, it generates a QR code for linking. After that, the session is cached and reconnects automatically.

License

MIT


Built by Adletic Agency

Related MCP Connectors

  • Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.

  • WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.

  • Drive your real WhatsApp inbox from Claude — send, reply, label, assign, and triage via TimelinesAI.

  • Atendio is a WhatsApp AI assistant for businesses in Latin America, on the official WhatsApp Business Platform. This MCP server lets Claude (or any MCP client) list and read WhatsApp conversations, view analytics and assistant settings, and create, edit or delete the rules your AI assistant follows. Remote, OAuth 2.1; the business always reviews and publishes rule changes.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables sending, reading, and deleting WhatsApp messages through Claude Desktop and other MCP clients with granular per-chat permissions. Built on whatsapp-web.js using a headless browser to automate WhatsApp Web.
    6
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables Claude to interact with WhatsApp on macOS through the Model Context Protocol. It allows reading messages, searching contacts, listing chats, and sending replies via natural conversation.
    2
    8
    40 PyPI
    2
    MIT