How to Use the WhatsApp Chat Export Parser MCP in Claude

Q: How do I find specific dates using WhatsApp Chat Export Parser with Claude Desktop?

Your AI client uses the parsewhatsappchat tool to process the export file. Once it's in structured JSON, you can ask your agent to filter records by date range or sender. It’s quick and keeps everything local.

Q: Does this MCP Server work on my private files?

Yep. Because it uses the local stdio transport when running in the Desktop App, your data never leaves your machine. You're parsing chat exports entirely offline.

Parse WhatsApp Chat Exports Locally and Build Apps Right in Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WhatsApp Chat Export Parser MCP to Claude Desktop

Create your Vinkius account to connect WhatsApp Chat Export Parser to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup WhatsApp Chat Export Parser with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Search local chat data anywhere.

You use the `parse_whatsapp_chat` tool to process a messy `.txt` file exported from WhatsApp. It reads through years of conversations and extracts clean, structured JSON right on your machine. This means your AI client can search specific chats for lost addresses or pinpoint when certain topics came up—all without sending private data anywhere.

Extract key details from long threads.

The `parse_whatsapp_chat` tool doesn't just give you text; it pulls out messages, who sent them, and exact timestamps. You feed the raw export file to your agent, and it instantly structures that information into a clean JSON format. This lets your AI client summarize long threads or calculate participant statistics for reporting—it makes sense of the noise.

Analyze chat data offline.

Since this tool works locally, you don't worry about uploading sensitive conversations to a cloud service. You just point your agent at the exported chat file on your hard drive. It runs as a subprocess via `stdio` transport, giving you full control over the private data while still letting Claude Desktop use it for powerful analysis.

Setup guide

Set up WhatsApp Chat Export Parser MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The WhatsApp Chat Export Parser MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the WhatsApp Chat Export Parser MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under whatsapp-chat-export-parser-mcp.

json

{
  "mcpServers": {
    "whatsapp-chat-export-parser-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by whatsapp-export. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect WhatsApp Chat Export Parser now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about WhatsApp Chat Export Parser MCP in Claude Desktop

Your AI client uses the `parse_whatsapp_chat` tool to process the export file. Once it's in structured JSON, you can ask your agent to filter records by date range or sender. It’s quick and keeps everything local.

Absolutely. You run the parser locally on a chat export file, which gives you structured data (messages, senders, timestamps). Your agent can then summarize that data into a report format you need.

It handles the raw chat export file. The tool extracts messages, identify senders, and records timestamps. You're getting structured JSON containing those participant statistics and message contents.

Yep. Because it uses the local `stdio` transport when running in the Desktop App, your data never leaves your machine. You're parsing chat exports entirely offline.

The server processes text-based conversation logs, specifically touching messages, senders, timestamps, and participant statistics extracted from the exported chat file.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript