Kaption WhatsApp
Read, search and organise your WhatsApp chats from an AI assistant via a browser extension
- Platforms
- Chrome extension, CLI, Web
- Runs
- Locally
- Version
- 0.5.11
- Listing updated
- today
Similar MCP servers
About Kaption WhatsApp
Kaption WhatsApp is an MCP server for communication. It runs locally on your machine and is started by your AI client.
Nothing connects to a hosted service here: the stdio server talks over a local websocket on port 7865 to the KaptionAI Chrome extension, which drives WhatsApp Web in your own browser. You install the extension, enable its MCP bridge, open web.whatsapp.com in Chrome or Edge, and point your client at the npm package. It also supports WebMCP for browser-native agents.
A single query tool searches conversations, contacts, messages, transcriptions, labels and communities with filters for unread chats, labels, dates and limits. Other tools summarise a conversation, manage Business labels, personal chat lists and chat state such as archive, pin, mute and draft messages, and handle reminders stored in the cloud. The bundled agent skill advises searching first and never sending without confirming.
The README lists config for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Zed and the OpenAI Agents SDK. Being tied to your logged-in WhatsApp Web session, it needs the browser open.
Install
Run in a terminal
claude mcp add mcp-extension -- npx -y @kaptionai/mcp-extensionAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-extension": {
"command": "npx",
"args": [
"-y",
"@kaptionai/mcp-extension"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-extension": {
"command": "npx",
"args": [
"-y",
"@kaptionai/mcp-extension"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-extension": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kaptionai/mcp-extension"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-extension": {
"command": "npx",
"args": [
"-y",
"@kaptionai/mcp-extension"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-extension": {
"command": "npx",
"args": [
"-y",
"@kaptionai/mcp-extension"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (10)
Taken from the project documentation; the running server may differ.
- query
- Searches conversations, contacts, messages, transcriptions, labels, communities and session info.
- summarize_conversation
- Generates a summary of a conversation.
- manage_labels
- Adds, removes, creates or deletes WhatsApp Business labels.
- manage_lists
- Creates, edits and deletes personal chat lists and their chats.
- list_chat_lists
- Lists custom chat lists.
- get_chat_list
- Returns a list with its chats.
- manage_chat
- Archives, pins, mutes, marks read and sets drafts.
- manage_reminders
- Creates, changes, completes or deletes reminders.
- list_reminders
- Lists reminders.
- get_reminder
- Returns one reminder.
What it does
- Search WhatsApp data
- Query conversations, contacts, messages, transcriptions and labels.
- Conversation summaries
- Generate a summary of a chat.
- Labels and lists
- Manage Business labels and personal chat lists.
- Chat state control
- Archive, pin, mute, mark read and set drafts.
- Reminders
- Create and manage reminders delivered via the extension.
- Agent skill
- Optional skill teaches safe usage such as confirming before sending.
Good for
- Find unread messages that mention a meeting
- Summarise a long group chat
- Organise chats into custom lists
- Draft a reply without sending it
- Set a follow-up reminder for a client chat
More servers for the same service
Kaption WhatsApp FAQ
What do I need besides the server?
The KaptionAI Chrome extension with its MCP bridge enabled, and WhatsApp Web open in Chrome or Edge.
How does it connect?
Over a local websocket at ws://localhost:7865.
Can it send messages?
The tool list covers drafts, and the skill advises never sending without confirmation.
Which clients are documented?
Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Zed and the OpenAI Agents SDK.
How do I add Kaption WhatsApp to Claude Code?
Run this command in your terminal: claude mcp add mcp-extension -- npx -y @kaptionai/mcp-extension
What are the best alternatives to Kaption WhatsApp?
The closest alternatives to Kaption WhatsApp are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

