WhatSync
WhatsApp for Windsurf
Add WhatSync to legacy Cascade and use saved WhatsApp messages while you code. Current Windsurf docs redirect to Devin Desktop, which has a different default agent and config path.
How do you connect WhatsApp to Windsurf?
For legacy Cascade, open the panel's Actions menu, then Open MCP config file. Add WhatSync under mcpServers with serverUrl. Current Devin Desktop docs place this file at ~/.config/devin/mcp_config.json on macOS and Linux. Devin Local uses separate CLI config; do not use this Cascade file for it.
- Works in
- Legacy Cascade in Windsurf / Devin Desktop
- You need
- An editor version with the legacy Cascade agent. WhatsApp on your phone, or a WhatsApp Business API number.
- WhatSync server
- Hosted for you. Nothing to run yourself.
What Windsurf can do with your WhatsApp
Fix what users report
Cascade reads the user's message and starts from their words.
Status updates
Draft the team update when the change lands, and approve it before it goes.
Add WhatSync to Windsurf
You sign in to WhatSync once. No API keys to paste. Check what you need above first.
Add the server
In Cascade's Actions menu, choose Open MCP config file and merge this into mcpServers. Current docs use ~/.config/devin/mcp_config.json on macOS/Linux or %APPDATA%\devin\mcp_config.json on Windows. Use the file your editor opens if an older Windsurf version uses a different location. Both serverUrl and url are supported.
{ "mcpServers": { "whatsync": { "serverUrl": "https://whatsync.app/api/mcp" } } }Load the server and sign in
Save the file, enable WhatSync in Cascade's MCPs section and complete OAuth sign-in when prompted. Reload the server if your editor requires it.
Link your WhatsApp
Open your WhatSync dashboard and link your personal WhatsApp from Linked devices on your phone, or connect the WhatsApp Business API. If you ask your agent something first, it replies with a sign-in link that works for 15 minutes.
Choose what it can see
On the What's saved page, enable message saving, pick the groups to include and keep any person out. Groups stay off until you tick them. The agent can read permitted messages saved since you enabled saving; linking does not import your entire WhatsApp history.
Things to ask Windsurf
Copy one, change the names, and try it.
Use WhatSync to read the last messages in the Support group and list the bugs.
Find what Dev said about the payment webhook and check our handler.
Draft a WhatsApp to Dev saying the webhook fix is deployed. Show it to me first.
Good to know
You choose which chats are saved, and you can unlink WhatsApp from your phone at any time. How we handle your data.
- These instructions cover legacy Cascade. The current default Devin Local agent uses Devin CLI configuration instead.
- On teams with an MCP allow list, an admin must add WhatSync to it.
- Sends are real WhatsApp messages and run when your AI app allows the tool call. Keep send tools on manual approval and review the recipient and text. Asking the agent to wait is not an enforced approval setting.
- Use the Business API for campaigns to customers who opted in. The Business API does not permit unsolicited messages. Linked personal accounts can be restricted for violating WhatsApp's rules.
- Search covers saved message text, file names and captions. WhatSync does not index document contents, transcribe voice notes or read text inside images. A download link is available only when WhatSync saved the file.
- Group searches and replies require a linked personal WhatsApp. WhatsApp Business API tools work with customer conversations, templates and campaigns.
- An unanswered conversation means its latest saved message in the checked period is incoming. It is a follow-up signal, not proof that a question is unanswered or that you owe a reply.
Personal WhatsApp or the Business API
Windsurf can tell which one you have and uses the right tools for it.
Your personal WhatsApp
- Link the WhatsApp you already use, like WhatsApp Web
- Chats, groups, files, polls and reactions
- For normal one-to-one use, not bulk sending
WhatsApp Business API
- Templates and campaigns your agent can send
- Meta reviews templates and charges per message
- Only for customers who opted in
Questions
Something else? Ask us.
Why does Windsurf not see the server?
Do I need to install anything?
Does it work with the WhatsApp Business API?
Is WhatSync made by Cognition?
How much does it cost?
Sources
We checked these steps against Windsurf's own docs on October 13, 2026. Menus change, so a screen may look a little different. WhatSync is not made or endorsed by Cognition.
Use it in your other AI apps too
One WhatSync account works in all of them. Each guide says what you need.
Put your WhatsApp to work in Windsurf
Your WhatsApp keeps working on your phone as normal. Unlink it whenever you like.