@clickonsearch/whatsapp-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,80 @@
+# @clickonsearch/whatsapp-mcp-server
+
+Connects to **your personal WhatsApp account** (the same way WhatsApp Web
+does — scan a QR code, keep a linked-device session) via
+[Baileys](https://github.com/WhiskeySockets/Baileys), and exposes it as an
+MCP server: `send_message`, `list_chats`, `get_recent_messages`,
+`search_contacts`, plus a plain SSE stream of incoming messages for anything
+that wants to react to them live.
+
+> **This is not the official WhatsApp Business API.** It's an unofficial
+> library automating a personal account, which is outside WhatsApp's ToS for
+> bots. Risk is generally low for personal, low-volume use, but there's a
+> real (if small) chance of the account being flagged. Go in aware of that.
+
+## Why an MCP server, not just a script
+
+Any of this repo's remote MCP bridges (`openai-remote-mcp-bridge`,
+`claude-remote-mcp-bridge`, `deepseek-remote-mcp-bridge`) can already
+connect to **any** MCP server over Streamable HTTP — including this one,
+running on `localhost`. This server needed zero special-casing in those
+bridges; it just had to speak the same protocol GitHub's remote MCP server
+does.
+
+## Setup
+
+```bash
+cd mcp-servers/whatsapp-mcp-server
+npm install
+cp .env.example .env
+```
+
+## Run
+
+```bash
+npm run dev
+```
+
+On first run it prints a QR code in the terminal — scan it from your phone:
+**WhatsApp → Settings → Linked devices → Link a device**. The session is
+then saved to `WHATSAPP_AUTH_DIR` (default `./whatsapp-auth`) so you won't
+need to re-scan on restart, unless you log the device out from your phone.
+
+Once connected:
+
+- `POST http://localhost:4100/mcp` — the MCP endpoint (Streamable HTTP,
+  stateless — same shape as the SDK's own reference server).
+- `GET http://localhost:4100/events` — SSE stream of every incoming
+  message: `{ chatId, fromMe, senderName, text, timestamp }`.
+- `GET http://localhost:4100/health` — `{ ok, connected, self }`, where
+  `self` is your own normalized JID once connected.
+
+## Config
+
+| Env var             | Default            | Notes                                         |
+| -------------------- | ------------------ | ---------------------------------------------- |
+| `PORT`               | `4100`              |                                                 |
+| `WHATSAPP_AUTH_DIR`  | `./whatsapp-auth`   | Your session — never commit this directory     |
+| `BAILEYS_LOG_LEVEL`  | `silent`            | `info`/`debug` if you need to see WA internals |
+
+## Tools
+
+| Tool                  | Args                          | Notes                                          |
+| ---------------------- | ------------------------------ | ----------------------------------------------- |
+| `send_message`         | `to`, `text`                    | `to` accepts a phone number or a raw JID        |
+| `list_chats`           | —                               | Includes history Baileys backfills on connect, plus anything live since |
+| `get_recent_messages`  | `chat`, `limit` (default 20)   | In-memory only, capped at the last 200/chat — how far back that reaches depends on how much history WhatsApp backfilled on connect |
+| `search_contacts`      | `query`                        | Matches by name or number substring             |
+
+## Using it as a library
+
+```ts
+import { WhatsAppConnection } from "./src/whatsapp.js";
+import { createServer } from "./src/server.js";
+
+const whatsapp = new WhatsAppConnection("./whatsapp-auth");
+await whatsapp.start();
+
+const app = createServer(whatsapp);
+app.listen(4100);
+```

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "dotenv/config";

package/dist/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { WhatsAppConnection } from "./whatsapp.js";
+import { createServer } from "./server.js";
+async function main() {
+    const authFolder = process.env.WHATSAPP_AUTH_DIR ?? "./whatsapp-auth";
+    const port = Number(process.env.PORT ?? 4100);
+    const whatsapp = new WhatsAppConnection(authFolder);
+    await whatsapp.start();
+    const app = createServer(whatsapp);
+    app.listen(port, () => {
+        console.error(`whatsapp-mcp-server listening on http://localhost:${port}`);
+        console.error(`  MCP endpoint: POST http://localhost:${port}/mcp`);
+        console.error(`  Events:       GET  http://localhost:${port}/events`);
+        console.error(`  Health:       GET  http://localhost:${port}/health`);
+    });
+}
+main().catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,iBAAiB,CAAC;IACtE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IAEvB,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACnC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,OAAO,CAAC,KAAK,CAAC,qDAAqD,IAAI,EAAE,CAAC,CAAC;QAC3E,OAAO,CAAC,KAAK,CAAC,yCAAyC,IAAI,MAAM,CAAC,CAAC;QACnE,OAAO,CAAC,KAAK,CAAC,yCAAyC,IAAI,SAAS,CAAC,CAAC;QACtE,OAAO,CAAC,KAAK,CAAC,yCAAyC,IAAI,SAAS,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { WhatsAppConnection, normalizeJid } from "./whatsapp.js";
+export { WhatsAppStore } from "./store.js";
+export type { StoredMessage, StoredContact } from "./store.js";
+export { createServer } from "./server.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export { WhatsAppConnection, normalizeJid } from "./whatsapp.js";
+export { WhatsAppStore } from "./store.js";
+export { createServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+import type { Express } from "express";
+import { WhatsAppConnection } from "./whatsapp.js";
+/**
+ * Builds the Express app: `POST /mcp` is the MCP endpoint (stateless —
+ * a fresh McpServer per request, matching the SDK's own stateless example),
+ * `GET /events` is a plain SSE stream of incoming WhatsApp messages (not
+ * part of MCP itself — MCP is request/response, so a consumer that wants
+ * to react to new messages needs a separate push channel), and `GET /health`
+ * reports connection status.
+ */
+export declare function createServer(whatsapp: WhatsAppConnection): Express;

package/dist/server.js

@@ -0,0 +1,93 @@
+import * as z from "zod/v4";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { normalizeJid } from "./whatsapp.js";
+function buildMcpServer(whatsapp) {
+    const server = new McpServer({ name: "whatsapp-mcp-server", version: "0.1.0" }, { capabilities: {} });
+    server.registerTool("send_message", {
+        description: "Send a WhatsApp text message to a contact or group",
+        inputSchema: {
+            to: z.string().describe("Phone number (e.g. 15551234567) or a raw WhatsApp JID"),
+            text: z.string().describe("Message text to send"),
+        },
+    }, async ({ to, text }) => {
+        await whatsapp.sendMessage(to, text);
+        return { content: [{ type: "text", text: `Sent to ${to}` }] };
+    });
+    server.registerTool("list_chats", { description: "List known WhatsApp chats, including recent history synced on connect", inputSchema: {} }, async () => {
+        const chats = whatsapp.store.listChats();
+        return { content: [{ type: "text", text: JSON.stringify(chats, null, 2) }] };
+    });
+    server.registerTool("get_recent_messages", {
+        description: "Get recent messages from a WhatsApp chat",
+        inputSchema: {
+            chat: z.string().describe("Chat JID or phone number"),
+            limit: z.number().int().min(1).max(200).default(20).describe("Max messages to return"),
+        },
+    }, async ({ chat, limit }) => {
+        const messages = whatsapp.store.getRecentMessages(normalizeJid(chat), limit);
+        return { content: [{ type: "text", text: JSON.stringify(messages, null, 2) }] };
+    });
+    server.registerTool("search_contacts", {
+        description: "Search known WhatsApp contacts by name or number",
+        inputSchema: { query: z.string().describe("Name or number substring to search for") },
+    }, async ({ query }) => {
+        const results = whatsapp.store.searchContacts(query);
+        return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
+    });
+    return server;
+}
+/**
+ * Builds the Express app: `POST /mcp` is the MCP endpoint (stateless —
+ * a fresh McpServer per request, matching the SDK's own stateless example),
+ * `GET /events` is a plain SSE stream of incoming WhatsApp messages (not
+ * part of MCP itself — MCP is request/response, so a consumer that wants
+ * to react to new messages needs a separate push channel), and `GET /health`
+ * reports connection status.
+ */
+export function createServer(whatsapp) {
+    const app = createMcpExpressApp();
+    app.post("/mcp", async (req, res) => {
+        try {
+            const server = buildMcpServer(whatsapp);
+            const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+            res.on("close", () => {
+                void transport.close();
+                void server.close();
+            });
+        }
+        catch (error) {
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: "2.0",
+                    error: { code: -32603, message: error instanceof Error ? error.message : String(error) },
+                    id: null,
+                });
+            }
+        }
+    });
+    app.get("/health", (_req, res) => {
+        res.json({ ok: true, connected: whatsapp.isReady, self: whatsapp.selfId ?? null });
+    });
+    app.get("/events", (req, res) => {
+        res.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache, no-transform",
+            Connection: "keep-alive",
+            "X-Accel-Buffering": "no",
+        });
+        res.write(": connected\n\n");
+        const onMessage = (message) => {
+            res.write(`data: ${JSON.stringify(message)}\n\n`);
+        };
+        whatsapp.on("message", onMessage);
+        req.on("close", () => {
+            whatsapp.off("message", onMessage);
+        });
+    });
+    return app;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -0,0 +1,35 @@
+export interface StoredMessage {
+    chatId: string;
+    fromMe: boolean;
+    /** True when `chatId` is the user's own "Message yourself" chat. */
+    isSelfChat: boolean;
+    senderName?: string;
+    text: string;
+    timestamp: number;
+}
+export interface StoredContact {
+    id: string;
+    name?: string;
+}
+/**
+ * In-memory only, not persisted across restarts. Populated both from
+ * Baileys' one-time history backfill on connect (see whatsapp.ts's
+ * "messaging-history.set" handler) and from live messages afterward, so
+ * this has enough recall for the agent to answer "what did they say" /
+ * "who is X" without needing its own database.
+ */
+export declare class WhatsAppStore {
+    private messagesByChat;
+    private contacts;
+    private readonly maxMessagesPerChat;
+    recordMessage(message: StoredMessage): void;
+    recordContact(id: string, name?: string): void;
+    listChats(): {
+        chatId: string;
+        name?: string;
+        lastMessageAt?: number;
+        messageCount: number;
+    }[];
+    getRecentMessages(chatId: string, limit: number): StoredMessage[];
+    searchContacts(query: string): StoredContact[];
+}

package/dist/store.js

@@ -0,0 +1,41 @@
+/**
+ * In-memory only, not persisted across restarts. Populated both from
+ * Baileys' one-time history backfill on connect (see whatsapp.ts's
+ * "messaging-history.set" handler) and from live messages afterward, so
+ * this has enough recall for the agent to answer "what did they say" /
+ * "who is X" without needing its own database.
+ */
+export class WhatsAppStore {
+    messagesByChat = new Map();
+    contacts = new Map();
+    maxMessagesPerChat = 200;
+    recordMessage(message) {
+        const list = this.messagesByChat.get(message.chatId) ?? [];
+        list.push(message);
+        if (list.length > this.maxMessagesPerChat)
+            list.shift();
+        this.messagesByChat.set(message.chatId, list);
+    }
+    recordContact(id, name) {
+        if (!name)
+            return;
+        this.contacts.set(id, { id, name });
+    }
+    listChats() {
+        return [...this.messagesByChat.entries()].map(([chatId, messages]) => ({
+            chatId,
+            name: this.contacts.get(chatId)?.name,
+            lastMessageAt: messages.at(-1)?.timestamp,
+            messageCount: messages.length,
+        }));
+    }
+    getRecentMessages(chatId, limit) {
+        const list = this.messagesByChat.get(chatId) ?? [];
+        return list.slice(-limit);
+    }
+    searchContacts(query) {
+        const q = query.toLowerCase();
+        return [...this.contacts.values()].filter((c) => c.id.toLowerCase().includes(q) || c.name?.toLowerCase().includes(q));
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAChB,cAAc,GAAG,IAAI,GAAG,EAA2B,CAAC;IACpD,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnC,kBAAkB,GAAG,GAAG,CAAC;IAE1C,aAAa,CAAC,OAAsB;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,kBAAkB;YAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACxD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,aAAa,CAAC,EAAU,EAAE,IAAa;QACrC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;YACrE,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI;YACrC,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS;YACzC,YAAY,EAAE,QAAQ,CAAC,MAAM;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,iBAAiB,CAAC,MAAc,EAAE,KAAa;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,cAAc,CAAC,KAAa;QAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC3E,CAAC;IACJ,CAAC;CACF"}

package/dist/whatsapp.d.ts

@@ -0,0 +1,45 @@
+import { EventEmitter } from "node:events";
+import { WhatsAppStore } from "./store.js";
+/** Accepts a raw JID ("1555...@s.whatsapp.net") or a bare phone number and returns a JID. */
+export declare function normalizeJid(input: string): string;
+/**
+ * Owns one Baileys ("linked device") session for a personal WhatsApp
+ * account: QR pairing, session persistence, and buffering recent
+ * chats/messages/contacts so the MCP tools below have something to read.
+ */
+export declare class WhatsAppConnection extends EventEmitter {
+    readonly store: WhatsAppStore;
+    private socket?;
+    private selfJid?;
+    /**
+     * WhatsApp is rolling out privacy-preserving "LID" identities
+     * (`@lid` JIDs) alongside the classic phone-number JID
+     * (`@s.whatsapp.net`). On accounts where this has rolled out, your own
+     * "Message yourself" chat's `remoteJid` is the `@lid` form even though
+     * `socket.user.id` still reports the phone-number form — the two will
+     * never string-match, so both are tracked here and `isSelfChat` checks
+     * against either.
+     */
+    private selfLid?;
+    private readonly authFolder;
+    private readonly logger;
+    /**
+     * IDs of messages this connection sent via `sendMessage`. WhatsApp's
+     * multi-device sync echoes every sent message back through
+     * `messages.upsert` — including to a self-chat — with `fromMe: true`,
+     * indistinguishable from a message the human actually typed unless we
+     * track our own sends. Without this, any consumer that reacts to
+     * `fromMe` self-chat messages (like whatsapp-agent's instruction
+     * listener) will re-trigger on its own replies forever.
+     */
+    private readonly ownMessageIds;
+    constructor(authFolder: string);
+    get isReady(): boolean;
+    get selfId(): string | undefined;
+    /** True when `chatId` is your own "Message yourself" chat, in either JID form. */
+    isSelfChat(chatId: string): boolean;
+    start(): Promise<void>;
+    /** Extracts, dedupes against our own sends, and stores one incoming message. Returns it if it was actually stored. */
+    private recordMessage;
+    sendMessage(to: string, text: string): Promise<void>;
+}

package/dist/whatsapp.js

@@ -0,0 +1,182 @@
+import { EventEmitter } from "node:events";
+import makeWASocket, { useMultiFileAuthState, fetchLatestBaileysVersion, jidNormalizedUser, DisconnectReason, } from "@whiskeysockets/baileys";
+import pino from "pino";
+import qrcode from "qrcode-terminal";
+import { WhatsAppStore } from "./store.js";
+/** Accepts a raw JID ("1555...@s.whatsapp.net") or a bare phone number and returns a JID. */
+export function normalizeJid(input) {
+    const trimmed = input.trim();
+    if (trimmed.includes("@"))
+        return trimmed;
+    const digits = trimmed.replace(/[^\d]/g, "");
+    if (!digits) {
+        throw new Error(`"${input}" is not a valid phone number or WhatsApp JID`);
+    }
+    return `${digits}@s.whatsapp.net`;
+}
+function extractText(message) {
+    const content = message.message;
+    if (!content)
+        return undefined;
+    return (content.conversation ??
+        content.extendedTextMessage?.text ??
+        content.imageMessage?.caption ??
+        content.videoMessage?.caption ??
+        undefined);
+}
+function extractTimestamp(message) {
+    const raw = Number(message.messageTimestamp);
+    return (Number.isFinite(raw) && raw > 0 ? raw : Date.now() / 1000) * 1000;
+}
+/**
+ * Owns one Baileys ("linked device") session for a personal WhatsApp
+ * account: QR pairing, session persistence, and buffering recent
+ * chats/messages/contacts so the MCP tools below have something to read.
+ */
+export class WhatsAppConnection extends EventEmitter {
+    store = new WhatsAppStore();
+    socket;
+    selfJid;
+    /**
+     * WhatsApp is rolling out privacy-preserving "LID" identities
+     * (`@lid` JIDs) alongside the classic phone-number JID
+     * (`@s.whatsapp.net`). On accounts where this has rolled out, your own
+     * "Message yourself" chat's `remoteJid` is the `@lid` form even though
+     * `socket.user.id` still reports the phone-number form — the two will
+     * never string-match, so both are tracked here and `isSelfChat` checks
+     * against either.
+     */
+    selfLid;
+    authFolder;
+    logger = pino({ level: process.env.BAILEYS_LOG_LEVEL ?? "silent" });
+    /**
+     * IDs of messages this connection sent via `sendMessage`. WhatsApp's
+     * multi-device sync echoes every sent message back through
+     * `messages.upsert` — including to a self-chat — with `fromMe: true`,
+     * indistinguishable from a message the human actually typed unless we
+     * track our own sends. Without this, any consumer that reacts to
+     * `fromMe` self-chat messages (like whatsapp-agent's instruction
+     * listener) will re-trigger on its own replies forever.
+     */
+    ownMessageIds = new Set();
+    constructor(authFolder) {
+        super();
+        this.authFolder = authFolder;
+    }
+    get isReady() {
+        return Boolean(this.socket && this.selfJid);
+    }
+    get selfId() {
+        return this.selfJid;
+    }
+    /** True when `chatId` is your own "Message yourself" chat, in either JID form. */
+    isSelfChat(chatId) {
+        if (!this.selfJid && !this.selfLid)
+            return false;
+        const normalized = jidNormalizedUser(chatId);
+        return normalized === this.selfJid || normalized === this.selfLid;
+    }
+    async start() {
+        const { state, saveCreds } = await useMultiFileAuthState(this.authFolder);
+        const { version } = await fetchLatestBaileysVersion();
+        const socket = makeWASocket({
+            auth: state,
+            version,
+            logger: this.logger,
+            printQRInTerminal: false,
+        });
+        this.socket = socket;
+        socket.ev.on("creds.update", saveCreds);
+        socket.ev.on("connection.update", (update) => {
+            const { connection, qr, lastDisconnect } = update;
+            if (qr) {
+                console.error("\nScan this QR code in WhatsApp: Settings > Linked devices > Link a device\n");
+                qrcode.generate(qr, { small: true });
+            }
+            if (connection === "open") {
+                this.selfJid = socket.user ? jidNormalizedUser(socket.user.id) : undefined;
+                this.selfLid = socket.user?.lid ? jidNormalizedUser(socket.user.lid) : undefined;
+                console.error(`WhatsApp connected as ${this.selfJid}${this.selfLid ? ` (lid: ${this.selfLid})` : ""}`);
+                if (this.selfJid)
+                    this.emit("ready", this.selfJid);
+            }
+            if (connection === "close") {
+                this.selfJid = undefined;
+                this.selfLid = undefined;
+                const statusCode = lastDisconnect?.error?.output
+                    ?.statusCode;
+                const loggedOut = statusCode === DisconnectReason.loggedOut;
+                console.error(`WhatsApp connection closed${loggedOut ? " (logged out — delete the auth folder to relink)" : ", reconnecting..."}`);
+                if (loggedOut) {
+                    this.emit("logged-out");
+                }
+                else {
+                    void this.start();
+                }
+            }
+        });
+        socket.ev.on("contacts.upsert", (contacts) => {
+            for (const contact of contacts) {
+                this.store.recordContact(contact.id, contact.name ?? contact.notify);
+            }
+        });
+        // Live messages: record AND emit, so whatsapp-agent's listener reacts to them.
+        socket.ev.on("messages.upsert", ({ messages, type }) => {
+            if (type !== "notify" && type !== "append")
+                return;
+            for (const message of messages) {
+                const stored = this.recordMessage(message);
+                if (stored)
+                    this.emit("message", stored);
+            }
+        });
+        // One-time backfill Baileys sends right after connecting: without this,
+        // the store starts empty on every restart and list_chats/
+        // get_recent_messages only ever see activity that happens to arrive
+        // while the server is running. Recorded but never emitted — these are
+        // old messages, not new instructions for whatsapp-agent to act on.
+        socket.ev.on("messaging-history.set", ({ messages, contacts }) => {
+            for (const contact of contacts) {
+                this.store.recordContact(contact.id, contact.name ?? contact.notify);
+            }
+            for (const message of messages) {
+                this.recordMessage(message);
+            }
+        });
+    }
+    /** Extracts, dedupes against our own sends, and stores one incoming message. Returns it if it was actually stored. */
+    recordMessage(message) {
+        const chatId = message.key.remoteJid;
+        const text = extractText(message);
+        if (!chatId || !text)
+            return undefined;
+        if (message.key.id && this.ownMessageIds.has(message.key.id)) {
+            this.ownMessageIds.delete(message.key.id);
+            return undefined;
+        }
+        const stored = {
+            chatId,
+            fromMe: Boolean(message.key.fromMe),
+            isSelfChat: this.isSelfChat(chatId),
+            senderName: message.pushName ?? undefined,
+            text,
+            timestamp: extractTimestamp(message),
+        };
+        this.store.recordMessage(stored);
+        return stored;
+    }
+    async sendMessage(to, text) {
+        if (!this.socket) {
+            throw new Error("WhatsApp is not connected yet");
+        }
+        const sent = await this.socket.sendMessage(normalizeJid(to), { text });
+        const id = sent?.key?.id;
+        if (id) {
+            this.ownMessageIds.add(id);
+            // The echo normally arrives within a second or two; this is just a
+            // bound so an echo that never comes doesn't leak memory forever.
+            setTimeout(() => this.ownMessageIds.delete(id), 60_000).unref();
+        }
+    }
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.js","sourceRoot":"","sources":["../src/whatsapp.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@clickonsearch/whatsapp-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server that connects to a personal WhatsApp account (via Baileys) and exposes it as tools — send messages, list chats, read recent messages, search contacts — plus an SSE stream of incoming messages.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ClickOnSearch/ai-apps.git",
+    "directory": "mcp-servers/whatsapp-mcp-server"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "whatsapp-mcp-server": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@whiskeysockets/baileys": "^7.0.0-rc14",
+    "dotenv": "^16.4.5",
+    "express": "^4.21.1",
+    "pino": "^10.3.1",
+    "qrcode-terminal": "^0.12.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.7.5",
+    "@types/qrcode-terminal": "^0.12.2",
+    "tsx": "^4.19.1",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}