zapzero
Inbox zero for WhatsApp. No bot, no ban risk, your chats never leave your Mac.
Turn your WhatsApp Desktop into a local MCP for Claude, with a dedicated UX: a Mac app that runs the panel and an MCP server on your machine, so your Claude can read and help you sort your WhatsApp.
zapzero reads the WhatsApp Desktop app's own database on your Mac, read-only. AI triages every chat (who is waiting on whom, how urgent, who this person is to you) and drafts a reply in your own tone of voice for everyone waiting on you. You clear it from the keyboard: Y opens the chat in WhatsApp with the reply typed in, you press Enter. Next.
Names and messages are made up.
Why it is safe for your number
- Read-only. zapzero copies the database the official app already keeps on disk (
sqlite3 mode=ro + .backup) and works on the copy. It never writes to WhatsApp's files.
- No bot, no linked device, no unofficial API. Nothing talks to WhatsApp's servers. To WhatsApp, it's just you using the app.
- Nothing is sent by zapzero. A reply is typed into WhatsApp Desktop; you press Enter. Commitments (dates, prices, yes/no) are left
[in brackets] for you to fill, and Y selects a bracket instead of sending.
- No zapzero cloud. Snapshots and state live in
~/Library/Application Support/zap (chmod 700). Only the excerpt of each conversation goes to the model you choose, with your own key.
What you get
- Categories by when: Important or urgent · This week · Older than a week · You're waiting on them · Groups · Cleanup.
- Areas by who: Clients, Hiring, Team, Investors, Partners, Family, Friends, Home & services, Selling to you, Other. Once a day the AI suggests new areas from your pending chats ("Apartment renovation", "Events & talks"); accept one and it becomes a triage choice.
- Your voice ("Seu jeito"). After the first scan the AI reads ~150 of your own messages, your 40 busiest chats and the groups you write in most, and writes who you are, one editable field per topic (where you live, work, family, people who matter, current projects, routine, languages), plus a guide to how you write. Accept or edit each part; triage uses it to know who's who and every draft follows your tone.
- Performance ("Desempenho"). Week by week over the last 13: how often you answered within 24 h, how long you typically take, who never got an answer, split by saved contacts, strangers and groups. Computed from the snapshot, no AI. A "turn" is a message that arrives after you spoke and after an hour of silence, so a live back-and-forth counts once.
- Calendar, through your own Claude. When a reply names a time ("14h30 fica bom"), the panel offers "create the event in my calendar" (on by default,
C toggles). After you press Y, zapzero runs your Claude Code headless (claude -p) with exactly one tool allowed, your calendar connector's create-event, and the event lands in your calendar. If the other person wrote an e-mail in the chat, the panel offers to invite it (you see the address before Y; the server only accepts addresses that appear in that chat), with a Meet link. No e-mail yet? One click adds "Me passa seu e-mail que te mando o convite?" to the reply, and when they answer with it the chat shows "Adicionar no convite": your Claude adds them to the same event (only the update-event tool allowed). zapzero holds no calendar credentials. Settings: ZAP_CLAUDE, ZAP_CALENDAR_TOOL, ZAP_AGENT_MODEL.
- Use it from Claude.
bun run setup links a Claude Code skill: ask Claude "who's waiting on me?", "how fast did I answer this month?" or "I live in Rio, fix my profile", and it calls zapzero locally through bun run zap api …. No MCP server or token to configure (there is a local one too, below).
- Keyboard flow:
Y reply · E edit · R new draft · D resolved · A archive · S skip · I ignore this person forever · J/K move · Z undo · ⌘↵ reply from the editor.
- Runs in the background, re-reading WhatsApp every 15 minutes and only re-doing AI work for chats that changed.
The panel is in Portuguese or English (setup asks).
Requirements
- macOS with WhatsApp Desktop linked to your phone. Linking syncs about the last 3 months of messages; older chats show in the list without text.
- Bun 1.3+.
- Claude Code, logged in. zapzero runs it headless (
claude -p, no tools, no MCP) and your Claude subscription pays for triage, drafts, rewrites, profile and suggestions. Nothing else to pay or configure.
- Or a local model with Ollama: nothing leaves your Mac. Setup asks which AI to use, and the panel language (Portuguese or English).
- Optional: an OpenRouter key. It unlocks Jev (
typesafe/jev-1.14) for triage: faster than batching through Claude and about US$0.00005 per chat (US$0.09 to triage 1,600 chats). Without Claude Code, OpenRouter also runs the chat model (ZAP_LLM=openrouter).
Install
The app
Download zapzero for Mac (Apple Silicon), drag it to Applications and open it. It isn't signed by Apple yet: the first time, go to System Settings → Privacy & Security → Open Anyway. Then give zapzero Full Disk Access (same pane, Full Disk Access) and open it again.
The app starts zapzero's server on your Mac (desktop/, Tauri; the server is a bun build --compile sidecar) and shows the panel in a window. Quitting the app stops the server. If the launchd server from bun run setup is running, the app uses it. Build it yourself with bun run desktop.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
