How to Use the WhatsApp Chat Export Parser MCP in Windsurf

Q: How do I set up WhatsApp Chat Export Parser in Windsurf?

You add the server under mcpServers settings or use the Marketplace UI. Once connected, Windsurf's Cascade agent auto-discovers the parsewhatsappchat tool and makes it available for planning.

Find lost addresses and summarize years of conversations with your AI client in Windsurf.

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 Windsurf

Create your Vinkius account to connect WhatsApp Chat Export Parser to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Extracting Chat Data

The `parse_whatsapp_chat` tool handles the heavy lifting. You drop a WhatsApp chat export `.txt` file into Windsurf, and it instantly turns that messy text dump into clean JSON format. This structured data lets your agent search years of conversation history without needing to manually read through thousands of lines.

Analyzing Participants

Windsurf uses the parsed data to build participant statistics. You can ask it who talked the most or how many unique people were involved in a specific thread. This feature lets you quickly quantify chat dynamics, going beyond just reading names and dates.

Local Data Search

Don't rely on cloud services for sensitive data. You run the `parse_whatsapp_chat` tool locally. Your AI client searches the exported content—finding lost addresses, specific dates, or keywords—all while keeping the data private. This makes it a perfect utility when you need to summarize long threads without sending them anywhere.

Setup guide

Set up WhatsApp Chat Export Parser MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the WhatsApp Chat Export Parser MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my WhatsApp Chat Export Parser payment history." If connected, Cascade will call the WhatsApp Chat Export Parser tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Yep. Because Windsurf's agent can chain actions, it doesn't just parse the chat; it runs follow-up analyses too. You set a goal—like 'find every mention of my old job'—and Windsurf executes that query against the parsed JSON.

It handles the core chat messages, including the sender and exact timestamp. It takes those raw text exports you get from WhatsApp's 'Export Chat' feature and makes them searchable.

You add the server under `mcpServers` settings or use the Marketplace UI. Once connected, Windsurf's Cascade agent auto-discovers the `parse_whatsapp_chat` tool and makes it available for planning.

No. The parsing happens locally within your environment, so you're running analyses on the chat messages without sending them anywhere else. Your data stays put.

The server touches raw text messages and associated metadata like timestamps and sender identifiers, which it converts into structured JSON.

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