WhatsApp MCP Server

Connect Claude, ChatGPT, Cursor or any MCP client to the WhatsApp inbox in Kondo Desktop. Your agent can search chats, write drafts for you to send, and keep conversations labeled and on schedule.

How the WhatsApp MCP server works

Kondo hosts a Model Context Protocol (MCP) endpoint that talks to the Kondo desktop app on your computer. Any client that supports remote MCP servers over Streamable HTTP can connect to it.

What your agent can do in WhatsApp

• Search — Look up chats by contact, text, date, or whether they hold photos, videos, voice messages or files. Voice messages come with transcripts.
• Drafts — Prepare replies, or open a new conversation by contact or phone number. Nothing goes out until you send it from Kondo.
• Organizing — Add labels, archive, mark read or unread, mute, and set reminders.
• Contacts — Find people by name, phone, email or username, including address book contacts you haven't messaged, and keep a note on each.
• Snippets — Reuse saved templates, or create new ones with placeholders.

Connect your agent to WhatsApp

What you need first

1. Kondo desktop app must be open — MCP only works while the Kondo app is running on your computer. Install Kondo.
2. OAuth sign-in — You'll authenticate with your Kondo account the first time you connect.

Test the connection

Start with a read-only request such as "What inboxes do I have in Kondo?" Your agent should list your inboxes and labels without changing anything. If it can't find any Kondo tools or reports that Kondo is offline, check the fixes further down this page.

Add the WhatsApp skill

Once connected, give your assistant the Kondo skill so it knows how to use the tools well: what to ask first, how to pace itself, and what it can and cannot do. Save it as SKILL.md in your assistant’s skills folder, or paste its contents into the assistant’s instructions.

https://www.trykondo.com/skills/kondo-whatsapp.md

Read the skill.

Example prompts for WhatsApp

Here's what you can do once connected:

Catch up on unread chats

Prompt	What happens
"Show me my unread messages"	Returns a prioritized summary of your unread messages.

Draft WhatsApp replies in bulk

Prompt	What happens
"Draft a follow-up for every chat labeled Lead where I sent the last message more than 3 days ago."	Finds matching chats and saves a draft reply to each. You review and send manually.

Sort chats with labels

Prompt	What happens
"Label all recruiter messages as Recruiter"	Identifies recruiter chats and applies the label.

Stay on top of follow-ups

Prompt	What happens
"Which chats labeled Lead are waiting on my reply?"	Lists chats with that label where the other person sent the last message.
"Go through my chats from the last 3 days and set reminders for anything I need to follow up on."	Scans recent chats and identifies follow-ups.

Limits and privacy

• Drafts only. Your agent can't send. You review and send every message in Kondo.
• Read receipts are real. When your agent marks a chat read, the other person sees it in WhatsApp.
• Data privacy — Message data is read from the Kondo app on your computer. Command and response data passes through Kondo's relay in memory and is not stored. Privacy Policy.
• One computer at a time. Kondo Desktop has to be open, and only one computer answers your agent.

WhatsApp MCP tool reference

Accounts & inboxes

Tool	Description
read_status	Check that Kondo is open and answering, on which device, and when it was last seen
list_pairings	List your connected messaging accounts and whether each is online
list_inboxes	List inboxes, labels, and label filters
list_inbox	Browse the chats in an inbox, with filters (unread, date range, awaiting reply, needs my reply)
list_chats	Search chats by person name, message text, date, or media type (photos, videos, voice messages, files)
read_chat	Read the messages of one or more chats, including voice message transcripts
navigate	Open a chat, inbox, people, snippets, or a settings page in Kondo and bring the app to the front

Chat actions

Tool	Description
set_chat_draft	Save a draft reply, or a first message to someone you haven't messaged yet, by contact or phone number (does not send, you review and send it)
set_chat_label	Add, remove, or replace labels on chats
set_chat_archived	Archive, ignore, or restore chats
set_chat_flags	Mark chats read or unread, and mute or unmute them (marking read sends read receipts)
set_chat_reminder	Set or clear a reminder (archives the chat until the reminder is due)

People

Tool	Description
list_contacts	List or search people by name, phone, email, or username, including address book contacts you haven't messaged
read_contact	Read a person's details, labels, chats, and note
set_contact_label	Add, remove, or replace labels on people
set_contact_note	Set or append to the note kept about a person

Labels, inboxes & snippets

Tool	Description
set_label	Create a label, or rename or recolor one
set_inbox	Create, update, or delete an inbox that combines labels
list_snippets	List saved reply templates
read_snippet	Read a snippet's full content
set_snippet	Create or update a snippet with smart placeholders

Preferences

Tool	Description
read_preferences	Read your app preferences, including notifications and quiet hours
set_preferences	Change app preferences

Fix common WhatsApp MCP issues

Problem	Fix
No tools appear	Your assistant isn't connected yet. Finish the sign-in, or revoke the app in Settings > MCP and connect again.
Your assistant says Kondo is offline	Open Kondo on the computer your assistant names and try again.
Tools answer from another computer	Kondo answers from one device at a time. Open Settings > MCP on this computer and click Switch here.
MCP is off for your team	Your team admin turned it off. Ask them to turn on Allow MCP in Settings > Team.
Sign-in fails	Revoke the app in Settings > MCP under Connected apps, then reconnect.
Commands stop working	Quit and reopen Kondo, then try again. The app must stay open.

Remove an agent's access

To disconnect an MCP client, go to Settings > MCP, find the app under Connected apps and click Revoke. This immediately revokes access for that client.