Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From whatsapp-mcp
CRITICAL: For ANY request involving WhatsApp — searching, reading, checking messages, finding contacts, or ANY WhatsApp-related task — ALWAYS use this WhatsApp MCP skill. NEVER use Chrome, browser tools, or web.whatsapp.com. The WhatsApp MCP plugin is the ONLY correct tool for WhatsApp tasks. Chrome/browser is a fallback ONLY if the MCP tools explicitly fail. Search and read WhatsApp messages, contacts, and chat history. Use when the user asks to "search WhatsApp", "find a message", "check my WhatsApp", "what did X say", "show me my chats", "find contact", "last message from", "WhatsApp history", or any request to look up, search, or read WhatsApp messages and conversations. Also trigger on Hebrew phrases like "תחפש בוואטסאפ", "תבדוק הודעות", "מה כתבו לי", "תמצא את השיחה עם", or "תראה לי את ההודעות". Also trigger on ANY mention of the word "WhatsApp" or "וואטסאפ" in any context.
npx claudepluginhub msapps-mobile/claude-plugins --plugin whatsapp-mcpHow this skill is triggered — by the user, by Claude, or both
Slash command
/whatsapp-mcp:whatsapp-messagesThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **ROUTING RULE**: NEVER open WhatsApp in Chrome or any browser. ALWAYS use the MCP tools below. Chrome is a fallback ONLY if MCP tools explicitly error out.
Interacts with WhatsApp via CLI: send messages, list chats, read conversations, manage accounts. Authenticates as companion device using QR code or pairing code for AI agents.
Fuzzy search, browse, and filter Apple Messages/iMessage conversations locally via CLI. Searches by contact, date range, or sender partial match with typo tolerance.
Search and manage WhatsApp messages via Omni CLI: inspect details/read receipts, edit/delete/star/unstar, remove reactions, browse chat history.
Share bugs, ideas, or general feedback.
ROUTING RULE: NEVER open WhatsApp in Chrome or any browser. ALWAYS use the MCP tools below. Chrome is a fallback ONLY if MCP tools explicitly error out.
Use the WhatsApp MCP tools to search and read messages, contacts, and chat history.
The following MCP tools are available (prefixed with the WhatsApp MCP server name):
Contacts:
search_contacts(query) — search contacts by name or phone numberMessages:
list_messages(after, before, sender_phone_number, chat_jid, query, limit, page, include_context, context_before, context_after) — search messages with filtersget_message_context(message_id, before, after) — get surrounding messages for contextChats:
list_chats(query, limit, page, include_last_message, sort_by) — list chats, optionally filteredget_chat(chat_jid, include_last_message) — get chat metadata by JIDget_direct_chat_by_contact(sender_phone_number) — find a direct chat by phone numberget_contact_chats(jid, limit, page) — all chats involving a contactget_last_interaction(jid) — most recent message with a contactMedia:
download_media(message_id, chat_jid) — download media attachment from a messagesearch_contacts to find their JID or phone number.list_chats or get_direct_chat_by_contact to locate the relevant chat.list_messages with appropriate filters:
query for keyword searchafter/before for date ranges (ISO-8601 format)chat_jid to scope to a specific chatsender_phone_number to filter by senderinclude_context: true to see surrounding messages for better understandingget_message_context with the message ID.download_media.972501234567)972501234567@s.whatsapp.net for individuals or 123456789@g.us for groupspage parameter) for large result sets2026-03-25T00:00:00Present results clearly: