WhatsApp MCP: Cho Claude đọc tin nhắn WhatsApp của bạn (cách cài, chi phí thật và rủi ro)

WhatsApp MCP lets an AI agent read your WhatsApp messages

🇬🇧 Read in English

WhatsApp MCP là một máy chủ mã nguồn mở mới, cho phép AI agent như Claude tìm kiếm và đọc tin nhắn WhatsApp cá nhân của bạn, chạy ngay trong tài khoản Cloudflare của chính bạn. Nó được chia sẻ trên Hacker News ngày 18/10/2026 với tiêu đề “running free on Cloudflare” (chạy miễn phí trên Cloudflare) và đạt 94 điểm, 48 bình luận. Điểm cần lưu ý: hướng dẫn cài đặt yêu cầu gói Cloudflare trả phí, và tác giả thẳng thắn nói cách này vi phạm điều khoản của WhatsApp.

WhatsApp MCP cho AI agent đọc tin nhắn WhatsApp của bạn

Điểm chính

  • Là gì: WhatsApp MCP là một máy chủ nhỏ, chỉ đọc, kết nối tài khoản WhatsApp cá nhân của bạn với bất kỳ MCP client nào, gồm cả Claude Code và Claude Desktop.
  • Chỉ đọc: agent của bạn có thể đọc, tìm kiếm trong các cuộc trò chuyện và lưu tên cho số điện thoại. Nó không thể gửi bất cứ thứ gì.
  • Dữ liệu nằm ở đâu: trong một cơ sở dữ liệu SQLite bên trong Durable Object thuộc tài khoản Cloudflare của chính bạn. Theo tác giả, “Nothing goes anywhere else” (không có gì đi đâu khác).
  • Chi phí thật: hướng dẫn yêu cầu gói Cloudflare Workers Paid, mà tác giả mô tả là “a few dollars a month” (vài đô la mỗi tháng). Gói miễn phí chưa được thử.
  • Rủi ro: nó dùng cùng giao thức với WhatsApp Web thông qua thư viện mã nguồn mở Baileys. Tác giả nói điều này trái điều khoản của WhatsApp, với rủi ro thực tế thấp nhưng không phải bằng không.
  • Dành cho ai: một người, một tài khoản WhatsApp, một bản triển khai. Giấy phép: MIT.

Xem nhanh: video tóm tắt 30 giây.

WhatsApp MCP là gì?

MCP là viết tắt của Model Context Protocol. Đây là chuẩn để các trợ lý AI kết nối với công cụ và dữ liệu bên ngoài. Một “MCP server” cung cấp các công cụ; một “MCP client” (như Claude Code) gọi chúng.

WhatsApp không có API chính thức để đọc tin nhắn cá nhân của chính bạn. Tác giả muốn Claude trên điện thoại truy cập được WhatsApp của mình, nhưng các lựa chọn họ tìm thấy hoặc đòi hỏi WhatsApp Business, hoặc cần một máy chủ thật chạy Baileys. Vì vậy họ tự làm WhatsApp MCP để chạy trên Cloudflare Workers với tài khoản cá nhân.

Cách hoạt động như sau:

  • Bạn liên kết điện thoại một lần, giống như liên kết WhatsApp Web (Cài đặt, Thiết bị đã liên kết, Liên kết thiết bị).
  • Máy chủ trở thành một thiết bị được liên kết. Điện thoại của bạn vẫn là nguồn dữ liệu gốc và vẫn nhận thông báo như bình thường.
  • Máy chủ không giữ kết nối liên tục. Khi agent của bạn yêu cầu, và mỗi ngày một lần, nó kết nối, lấy những gì WhatsApp đã xếp hàng từ lần trước, lưu vào cơ sở dữ liệu riêng rồi ngắt kết nối.
  • Mỗi công cụ đọc sẽ cập nhật thêm từ WhatsApp trước nếu bản lưu đã cũ hơn mười phút.

Khi đã kết nối, bạn có thể hỏi agent những câu như “Dana đã nói gì về chuyến bay?” hoặc “Tóm tắt những gì tôi bỏ lỡ trong nhóm gia đình tuần này.”

AI agent làm được gì với các cuộc trò chuyện của bạn?

Máy chủ WhatsApp MCP cung cấp cho agent tám công cụ:

Công cụChức năng
list_chatsLiệt kê các cuộc trò chuyện, mới nhất trước. Lọc theo tên hoặc số.
get_messagesĐọc một cuộc trò chuyện, lật lùi hoặc tiến theo ngày.
search_messagesTìm kiếm toàn văn trong mọi cuộc trò chuyện hoặc trong một cuộc.
unnamed_chatsHiện các cuộc trò chuyện chỉ biết bằng số điện thoại, cuộc nhiều tin nhất trước.
set_contact_namesLưu tên cho số điện thoại. Tên cũng hiện trong các nhóm.
sync_nowKéo tin nhắn mới ngay lập tức.
link_statusCho biết đã liên kết chưa, lần kéo gần nhất và dung lượng đã lưu.
relinkHủy liên kết và bắt đầu lại. Con người phải quét mã QR mới.

Làm sao sửa các cuộc trò chuyện chỉ hiện số điện thoại?

WhatsApp không đưa cho thiết bị được liên kết mọi tên danh bạ. Thay vì tự đăng nhập vào một dịch vụ danh bạ, WhatsApp MCP giao việc đó cho agent của bạn. Hãy nói “tìm tên cho các cuộc trò chuyện chưa có tên.” Agent sẽ gọi unnamed_chats, đối chiếu số bằng một công cụ danh bạ nó đã có (ví dụ trình kết nối Google Contacts hoặc Gmail), rồi lưu tên bằng set_contact_names. Nó sẽ không tìm ra tất cả, vì phần lớn các cuộc trò chuyện chưa có tên chỉ là một tin nhắn từ người lạ.

Cách cài WhatsApp MCP trong 3 bước

Bạn cần một tài khoản Cloudflare ở gói Workers Paid, Node 20 trở lên và điện thoại của bạn. Tác giả cũng gợi ý trỏ agent của bạn vào repo và để nó tự lo việc cài đặt.

Bước 1: Triển khai lên Cloudflare thế nào?

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

# A place for sign-in tokens. Paste the id it prints into wrangler.jsonc.
npx wrangler kv namespace create OAUTH_KV

# A password for the page that links your phone (12+ characters).
npx wrangler secret put OWNER_PASSWORD

# Deploy.
npm run deploy

Wrangler (công cụ dòng lệnh của Cloudflare) sẽ in ra URL của bạn, dạng như https://whatsapp-mcp.your-name.workers.dev.

Bước 2: Liên kết WhatsApp ra sao?

Mở URL và quét mã QR bằng WhatsApp. Nếu bạn đang dùng chính chiếc điện thoại đó, hãy chọn tùy chọn dùng số điện thoại. Lần liên kết đầu tiên sẽ nhập lịch sử. Trang hiển thị tiến độ, và bạn có thể đóng trang mà không làm dừng quá trình nhập.

Bước 3: Kết nối agent bằng cách nào?

Trong Claude Code:

claude mcp add --transport http whatsapp https://your-url/mcp

Sau đó gõ /mcp và đăng nhập bằng mật khẩu của bạn. Các MCP client khác có thể trỏ đến cùng URL /mcp. Nếu bạn đã dùng các MCP server khác, hướng dẫn Playwright MCP của chúng mình giải thích chi tiết hơn về cùng quy trình phía client.

Chi phí WhatsApp MCP: có thật sự miễn phí?

Tiêu đề trên Hacker News nói “running free on Cloudflare”, nhưng hướng dẫn cài đặt lại nói khác.

Hạng mụcNguồn nói gì
Phần mềmMiễn phí và mã nguồn mở (giấy phép MIT)
Gói Cloudflare trong hướng dẫnWorkers Paid, “a few dollars a month”
Gói miễn phí của CloudflareTác giả chưa thử; lần nhập đầu tiên “expected to be fragile” (dự kiến sẽ dễ lỗi)
WhatsApp BusinessKhông bắt buộc; chạy được với tài khoản cá nhân

Vì sao cần gói trả phí? Việc nhập một lịch sử trò chuyện lớn giải mã rất nhiều dữ liệu cùng lúc, mà giới hạn CPU mặc định của Workers quá nhỏ. Tệp wrangler.jsonc của dự án nâng giới hạn đó, và điều này cần gói trả phí. Nếu bạn muốn thử gói miễn phí, tác giả nói hãy xóa khối limits và chuẩn bị gặp trục trặc ở lần nhập đầu.

Vậy câu trả lời thẳng thắn là: tải WhatsApp MCP về thì không tốn gì, nhưng cách cài được ghi trong tài liệu tốn vài đô la mỗi tháng.

WhatsApp MCP có an toàn không? Rủi ro và giới hạn

Đây là phần mà video đã cảnh báo. Hãy đọc trước khi quét bất kỳ mã QR nào.

Nó vi phạm điều khoản của WhatsApp. Theo lời tác giả: “This isn’t official.” (Cái này không chính thức.) WhatsApp MCP dùng giao thức WhatsApp Web thông qua Baileys, và “that’s against WhatsApp’s terms” (điều đó trái điều khoản của WhatsApp). Với một thiết bị liên kết chỉ đọc, tác giả coi rủi ro thực tế là thấp, “but it isn’t zero” (nhưng không phải bằng không). Lời khuyên của họ: chỉ dùng trên tài khoản của chính bạn, và đừng dùng nó để gửi tin nhắn.

Nó giữ dữ liệu rất riêng tư. Mỗi bản triển khai lưu toàn bộ lịch sử tin nhắn và một phiên đăng nhập đang hoạt động vào tài khoản của bạn. Đó là lý do nó được thiết kế chỉ cho một người. Ai cũng nên tự chạy bản triển khai của mình. Để hiểu rộng hơn về cách các công cụ AI xử lý dữ liệu cá nhân, xem bài của chúng mình về quyền riêng tư và trình theo dõi của chatbot AI.

Lịch sử có thể không đầy đủ. Lần liên kết đầu nhập bất kỳ lịch sử nào WhatsApp quyết định đưa cho thiết bị mới. Có thể không phải tất cả. Để nhập lại, bạn liên kết lại. Tin nhắn đã lưu vẫn được giữ, và lần nhập lại sẽ lấp các chỗ thiếu mà không bị trùng.

Không có media. Ảnh, tin nhắn thoại và tài liệu chỉ hiện dưới dạng nhãn như [image] hoặc [voice note 12s], kèm chú thích nếu có. Không có gì được tải về hay chuyển thành văn bản.

Liên kết lại. Nếu điện thoại báo thiết bị đã bị gỡ, hãy nhờ agent chạy relink, hoặc mở /setup và chọn “Unlink and scan again.”

Có nên kết nối Claude với WhatsApp không?

Ưu điểm

  • Cho Claude và các MCP client khác tìm kiếm và tóm tắt các cuộc trò chuyện WhatsApp thật của bạn.
  • Được thiết kế chỉ đọc, nên agent không thể gửi tin nhắn thay bạn.
  • Dữ liệu của bạn nằm trong tài khoản Cloudflare của chính bạn.
  • Không cần tài khoản WhatsApp Business và không cần máy chủ chạy liên tục để bảo trì.
  • Cách đặt tên liên hệ thông minh, tái sử dụng các công cụ agent của bạn đã có.

Nhược điểm

  • Trái điều khoản của WhatsApp, với rủi ro tài khoản nhỏ nhưng có thật.
  • Cách cài được ghi trong tài liệu cần gói Cloudflare trả phí, dù tiêu đề nói “miễn phí”.
  • Đòi hỏi bạn quen với dòng lệnh và Cloudflare.
  • Không tải được media, và việc nhập lịch sử có thể chỉ một phần.

Nếu bạn sống trên WhatsApp và đã làm việc với Claude Code, WhatsApp MCP là cách thông minh để AI tìm kiếm được các cuộc trò chuyện của bạn. Nếu tài khoản WhatsApp của bạn quan trọng cho công việc hoặc gia đình, rủi ro vi phạm điều khoản đáng được cân nhắc nghiêm túc trước. Nếu bạn mới làm quen với agent, hãy bắt đầu với workflow subagent của Claude Code để quen với công cụ.

Câu hỏi thường gặp về WhatsApp MCP

WhatsApp MCP có chính thức không?
Không. WhatsApp không có API để đọc tin nhắn cá nhân của chính bạn, và tác giả nói cách này trái điều khoản của WhatsApp.

WhatsApp MCP có gửi được tin nhắn không?
Không. Nó có thể đọc, tìm kiếm tin nhắn và lưu tên cho số điện thoại, nhưng không thể gửi bất cứ thứ gì.

WhatsApp MCP có miễn phí không?
Code miễn phí theo giấy phép MIT, nhưng hướng dẫn cài đặt yêu cầu gói Cloudflare Workers Paid, mà tác giả nói tốn vài đô la mỗi tháng.

WhatsApp MCP có dùng được với Claude không?
Có. Nó chạy với Claude Code, Claude Desktop và mọi client hỗ trợ MCP.

Tin nhắn của tôi được lưu ở đâu?
Trong cơ sở dữ liệu SQLite bên trong một Durable Object ở tài khoản Cloudflare của chính bạn. Theo tác giả, không có gì đi đâu khác.

Nguồn tham khảo

Cập nhật lần cuối: 30/10/2026

Trạm Công Nghệ AI
Logo
Compare items
  • Total (0)
Compare
0