Pull your WhatsApp chats, text and automatically transcribed voice notes, into files for your brain. It all happens inside your Claude Code desktop app. Everything runs on your own Mac, nothing is uploaded.
You need The Claude Code desktop app (Mac)Time ~20 minCost Free, runs locally
ⓘ
You do this by talking to your Claude Code app. Claude does the work. You only handle two quick one-time setup things below, then tell it which chats to import.
1
Get WhatsApp Desktop ready
One-time, and it's the part that takes the longest (mostly waiting for it to sync).
Install WhatsApp from the Mac App Store (the official app).
Open it. On your phone: WhatsApp → Settings → Linked Devices → Link a Device, scan the QR on the Mac.
When it offers to sync older chat history, say yes and let it finish.
2
Turn on Full Disk Access
macOS protects WhatsApp's data, so your Claude Code app needs permission to read it. This is the step everyone forgets, so do it now.
Open System Settings → Privacy & Security → Full Disk Access.
Turn it on for your Claude Code app (and for Terminal if it's listed).
Fully quit that app and reopen it , the permission doesn't apply until you do.
⚠
If Claude later says it "can't open the database", it's almost always this step. Turn it on, restart the app, and tell Claude to try again.
3
Save and unzip the file
Find the whatsapp-to-brain.zip that was sent to you.
Save it (your Downloads folder is fine) and double-click to unzip. Leave the files together.
4
Tell Claude to do it
Open your Claude Code app, copy this message and paste it in:
In my Downloads folder I unzipped a folder called "whatsapp-to-brain".
Open the file READ-THIS-CLAUDE.md inside it and follow those instructions
to import my WhatsApp chats into my brain.
ⓘ
If you saved the folder somewhere other than Downloads, just say where instead. You can also drag the folder into the chat.
5
Pick your chats, and approve
Claude shows your chat list. Tell it which chats to import (a few business ones is better than everything).
When it asks permission to run a step, click approve.
When it finishes, it tells you exactly where your chat files were saved.
The whole thing at a glance
Install & sync WhatsApp Desktop (one time)
→ Turn on Full Disk Access for your Claude Code app (one time)
→ Unzip the file (Downloads is fine)
→ Paste the message from Step 4 into Claude
→ Tell it which chats, approve each step
→ Done , Claude tells you where your files are
ⓘ
Privacy. Everything runs on your own Mac and nothing is uploaded. This can read your whole WhatsApp, so only the chats you name get imported. Group chats include other people's messages, so choose the ones you actually want.