whatsapp-messages

Search and read WhatsApp messages, contacts, and chat history via an MCP bridge.

8|1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/MSApps-Mobile/claude-plugins --skill whatsapp-messages
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whatsapp-messages
Source: https://github.com/MSApps-Mobile/claude-plugins/tree/main/plugins/whatsapp-mcp/skills/whatsapp-messages
Command: npx skills add https://github.com/MSApps-Mobile/claude-plugins --skill whatsapp-messages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a safe, reliable way to locate and read WhatsApp messages, contacts, and chat history without relying on browsers or web.whatsapp.com, preventing unsafe or inconsistent scraping methods.

Core Features & Use Cases

  • Contact search: find contacts by name or phone number and return JIDs or phone numbers.
  • Message search: query messages by keyword, sender, date range, chat JID, and include surrounding context.
  • Chat operations & media: list chats, fetch chat metadata, retrieve last interactions, and download media attachments.
  • Operational safety: enforces use of the WhatsApp MCP bridge, provides bridge health checks and restart/setup guidance, and treats browser access as a last-resort fallback.

Quick Start

Search my WhatsApp for messages from Avi containing the word flight between 2026-03-01 and 2026-03-10 and show surrounding context.

Frequently Asked Questions about whatsapp-messages

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search WhatsApp messages by keyword and date range without web scraping?

You can search WhatsApp messages by keyword, sender, and date range using a secure MCP bridge. This approach retrieves message content and surrounding context without relying on inconsistent browser scraping methods.

What is needed to read WhatsApp chat history and locate specific conversations?

Reading WhatsApp chat history requires a running WhatsApp MCP bridge and JIDs or international phone numbers to scope the search. The system uses these inputs to locate conversations, list chats, and retrieve message context safely.

Can I download media attachments from a specific WhatsApp chat?

Yes, you can download media attachments from a specific WhatsApp chat by using the MCP bridge. The skill supports fetching chat metadata, retrieving last interactions, and downloading media files directly through the bridge connection.

Does searching WhatsApp contacts require a JID or can I use a phone number?

Searching WhatsApp contacts supports both approaches. You can find contacts by name or phone number, and the system returns JIDs or formatted international phone numbers to scope subsequent message queries.

What is the safest way to retrieve WhatsApp message context for specific contacts?

The safest way to retrieve WhatsApp message context is by using the WhatsApp MCP bridge with health checks. This enforces operational safety by treating browser access as a last-resort fallback and providing restart guidance if the connection fails.

Are there limitations when querying large WhatsApp chat histories?

Querying large WhatsApp chat histories is supported through pagination and date filters. You must provide a JID or international phone number for scoping, and the system relies on a stable MCP bridge connection to return results without timing out.