Skip to content
MCP server

Kaption WhatsApp

Read, search and organise your WhatsApp chats from an AI assistant via a browser extension

Runs locallyStatus and history
Install
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-extension

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-extension": {
      "command": "npx",
      "args": [
        "-y",
        "@kaptionai/mcp-extension"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-extension": {
      "command": "npx",
      "args": [
        "-y",
        "@kaptionai/mcp-extension"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers