WhatsApp MCP
官方通过你自己的号码，从你的 AI 读取、搜索并回复你的 WhatsApp 聊天。
你可以用 WhatsApp MCP 做什么？
- 查找谁在等待回复 — 询问哪些聊天的最后一条消息尚未回复，使用
get_unanswered_chats查看谁需要回复。 - 搜索你的消息 — 使用
search_messages在所有聊天中，或在单个聊天或联系人中搜索消息文本。 - 以你的风格起草 — 使用
get_writing_style提取你的写作示例，让起草的回复听起来像你本人。 - 发送或定时发送 — 使用
send_message发送文本或文件链接，或使用schedule_message设置一次性或重复消息。 - 管理已发送的消息 — 用表情符号回应、编辑自己的文本、为所有人删除消息，或将聊天标记为已读。
- 关联并检查状态 — 通过二维码或配对码开始关联，检查 WhatsApp 是否已连接，或重启会话。
托管 MCP 服务器
npx add-mcp 'https://server.wa-mcp.com/mcp'可安装到 Claude Code、Codex、Cursor 等客户端
文档
WhatsApp MCP 文档
WhatsApp MCP 可将你的 AI 助手（Claude、ChatGPT、Cursor 或任何支持模型上下文协议（Model Context Protocol）的客户端）连接到你正在使用的 WhatsApp 号码。你的助手可以读取和搜索聊天记录、找出谁在等待回复，并发送、定时、编辑消息或对消息添加回应，始终使用你自己的号码，且仅在你要求时执行。
它像 WhatsApp Web 一样，以关联设备的方式连接到 WhatsApp。无需安装应用、无需新号码，也无需 Meta Business API。
设置
你只需连接一次，然后在聊天中关联你的 WhatsApp。
方式 A：Claude 的连接器目录
- 在 Claude 中打开连接器目录，找到 WhatsApp MCP。
- 点击 Connect。我们的连接页面会打开：确认页面显示的是你的 AI 应用，然后再次点击 Connect。
- 回到 Claude，打开一个新聊天，输入 “Connect my WhatsApp”（参见下方“关联你的 WhatsApp”）。
无需注册或密码：你的 WhatsApp 号码就是你的账户，关联号码即是我们确认你身份的方式。
方式 B：个人连接 URL（适用于任何 MCP 客户端）
- 访问 wa-mcp.com，选择你的 AI 应用并点击 Generate my link。
- 将该链接作为自定义连接器（MCP 服务器）添加到你的 AI 应用。网站会显示每个应用的具体步骤，How to Connect Claude to WhatsApp 也逐步介绍了 Claude 的操作方法。
- 打开一个新聊天，输入 “Connect my WhatsApp”。
请妥善保管该链接：它的作用类似于密码。你可以在多个 AI 应用中使用同一个链接。
关联你的 WhatsApp
当你要求助手连接你的 WhatsApp 时，它会提供两种方式：
- 二维码： 你的助手会显示一个二维码（以及包含该二维码的页面链接）。在手机上打开 WhatsApp → 设置 → 关联设备 → 关联设备，然后扫描二维码。
- 配对码： 将你的手机号码（含国家代码）提供给助手。它会返回一个 8 位字符的配对码。在手机上打开 关联设备 → 关联设备 → 改用手机号码关联，然后输入该配对码。
关联后，WhatsApp 会将你的近期历史记录（最多约 90 天）同步到关联设备，对于大型账户可能需要几分钟。
套餐
- 免费试用： 首次关联手机后 1 小时内可使用全部功能。
- 免费套餐： 试用结束后，读取、总结和搜索聊天记录以及发送文本消息仍可正常使用。文本消息末尾会带有“Sent via wa-mcp.com”，且无法发起新对话（即过去 90 天内未给你发过消息的人）。
- 付费套餐： 文件（照片、视频、语音消息、文档）、定时消息、编辑、回应和删除消息、带防封禁保护措施的新对话，且无标签。
向你的助手询问 “What plan am I on?” 即可查看你的套餐和订阅选项。
工具
你的助手会选择工具；你只需用日常语言提出请求即可。
读取
| 工具 | 功能 |
|---|---|
get_recent_chats | 你最近的聊天，以及每个聊天的最后一条消息。 |
get_unanswered_chats | 最后一条消息来自对方的聊天，方便你查看谁在等待回复。 |
read_chat_history | 某个聊天、联系人或群组的消息。 |
search_messages | 搜索你消息中的文本，可选择限定在某个聊天或某个人。 |
search_contacts | 按名称或号码查找联系人或群组。 |
download_media | 打开某条消息中的照片、语音消息、视频、文档或贴纸。 |
get_writing_style | 你写作风格的示例，让你收到的草稿听起来像你本人写的。 |
写入
| 工具 | 功能 |
|---|---|
send_message | 向某个人或群组发送文本，或发送来自链接的文件。会先显示正在输入指示。 |
schedule_message | 定时发送消息，可单次或重复（每天、每周、每月等）。 |
list_scheduled_messages | 列出即将发送的定时消息以及过去消息的历史记录。 |
cancel_scheduled_message | 取消定时消息（包括其所有重复项）。 |
react_to_message | 用表情符号回应某条消息，或移除回应。 |
edit_message | 修改你自己某条消息的文本。 |
delete_message | 为所有人删除你自己的某条消息。 |
mark_as_read | 将某个聊天标记为已读。 |
连接与账户
| 工具 | 功能 |
|---|---|
get_session_status | 你的 WhatsApp 是否已关联并连接。 |
get_pairing_qr | 通过二维码开始关联。 |
request_pairing_code | 通过配对码开始关联。 |
restart_session | 如果消息停止接收，重新连接到 WhatsApp。 |
manage_subscription | 显示你的套餐和订阅选项。 |
report_feedback | 向我们发送错误报告或功能请求。 |
unlink_whatsapp | 取消关联你的 WhatsApp（你的账户保留）。 |
delete_account | 在你确认后删除你的账户及其所有数据。 |
示例提示词
- “从昨天开始谁在等我回复？”
- “总结一下家庭群这周聊了什么。”
- “找到 Carlos 发给我地址的那条消息。”
- “告诉 Ana 订单周四发货。”（除非你给出了确切的措辞，否则你的助手会先向你展示草稿）
- “每周一上午 9 点，提醒团队群发送每周更新。”
安全
- 发送内容始终由你掌控。 当你的助手为你撰写消息时，除非你给出了确切的文本，否则它会在发送前向你展示草稿。
- 防封禁保护措施。 向过去 90 天内未给你发过消息的人发送消息会限制频率（每分钟最多 1 条，每 12 小时最多 10 个不同的人），因为这类行为会导致号码被标记为垃圾信息。与给你发过消息的人的聊天不受限制。没有群发工具。
- 正在输入指示。 每条消息发送前会短暂显示“正在输入…”，就像你亲自输入一样。
故障排除
- “WhatsApp is not linked”：关联设备已被移除（从你的手机上，或通过取消关联）。请让助手用同一号码重新连接你的 WhatsApp。
- 配对码无效：配对码会在短时间后过期。请重新获取一个，检查号码是否包含国家代码，并在手机上使用 改用手机号码关联。
- 消息停止接收：请让助手重启你的 WhatsApp 连接。如果你手机上的 WhatsApp 已离线约 14 天，WhatsApp 会登出关联设备：请在手机上打开 WhatsApp，然后重新关联。
- “This connection is permanently registered to phone number…”：每个连接只属于一个手机号码。要使用其他号码，请先取消关联，然后移除连接器并重新添加（如果使用个人 URL，则生成一个新的）。
- 连接器显示未连接（目录用户）：从你的连接器中移除 WhatsApp MCP 并重新连接，然后关联同一手机号码。你的账户和订阅会保留。
隐私与你的数据
你的消息会在我们的服务器上保存 90 天，以便你的助手搜索，且绝不会用于广告或 AI 训练。你的助手读取的内容由其提供商按照其政策处理。你可以随时让助手取消关联你的 WhatsApp 或删除你的账户；删除会立即移除所有内容。完整详情请参阅我们的隐私政策和条款。