MCP servers

WhatsApp MCP server: connect Claude, ChatGPT and Cursor to your chats

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.

Using LinkedIn? Kondo runs it in your browser, with a separate server and its own tools: see Kondo's LinkedIn MCP server.

Connect your agent to WhatsApp

What you need first

MCP is available on the Business and Enterprise plans.

A team admin can turn MCP off for the whole team under Settings > Team > Allow MCP.

Kondo desktop app must be open — MCP only works while the Kondo app is running on your computer. Install Kondo.
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.