WhatsApp Chat Parser

Parse WhatsApp chat exports into structured JSON data.

16|5|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/ShenSeanChen/launch-agent-skills --skill whatsapp-chat-parser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: WhatsApp Chat Parser
Source: https://github.com/ShenSeanChen/launch-agent-skills/tree/main/skills/whatsapp-parser
Command: npx skills add https://github.com/ShenSeanChen/launch-agent-skills --skill whatsapp-chat-parser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts plain-text WhatsApp chat exports into structured JSON data, extracting participants, timestamps, messages, and media indicators to enable easy analysis and archival.

Core Features & Use Cases

  • Structured Output: Produces a JSON object with metadata (participants, date range, message count) and an array of messages with sender, timestamp, and content.
  • Format Compatibility: Handles common WhatsApp export formats and variations across regions, including media placeholders and system messages.
  • Use Case: Build searchable chat histories, perform analytics on activity patterns, or migrate chats to other data stores.

Quick Start

Run the parser on a sample WhatsApp export file and inspect the resulting JSON to verify metadata accuracy and message content capture.

Frequently Asked Questions about WhatsApp Chat Parser

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

FAQPage Schema
How do I parse a WhatsApp chat export into JSON?

Parsing a WhatsApp chat export into JSON is done by processing the plain-text file with a regex-based parser that extracts timestamps, senders, and messages into structured records. The output is a JSON object containing metadata and an array of messages.

What data structure is returned when parsing WhatsApp messages?

The data structure returned is a JSON object containing metadata and an array of message records. Metadata includes participants, date range, and message count, while each record contains the sender, timestamp, and message content.

Does the WhatsApp parser handle system messages and media placeholders?

Yes, the WhatsApp parser handles system messages and media placeholders. It processes plain-text exports to extract these indicators alongside standard participant messages and timestamps into structured JSON records.

Can I use this to extract chat participants and date ranges from WhatsApp exports?

Yes, you can extract chat participants and date ranges from WhatsApp exports. The parser generates JSON metadata that includes the list of participants, the overall date range, and the total message count.

Are there limitations when converting WhatsApp exports across different regions?

The parser handles common WhatsApp export format variations across different regions. However, highly non-standard plain-text formatting may affect regex-based extraction of participants, timestamps, and messages.