# Kaption WhatsApp

> Kaption WhatsApp is an MCP server for communication. Read, search and organise your WhatsApp chats from an AI assistant via a browser extension. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** Chrome extension, CLI, Web, whatsapp
- **Repository:** https://github.com/kaption-ai/mcp-extension
- **MCP Registry name:** io.github.Kaption-AI/mcp-extension
- **Categories:** [communication](https://ai-powered.com/categories/communication), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-extension -- npx -y @kaptionai/mcp-extension
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-extension": {
      "command": "npx",
      "args": [
        "-y",
        "@kaptionai/mcp-extension"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-extension": {
      "command": "npx",
      "args": [
        "-y",
        "@kaptionai/mcp-extension"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-extension": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@kaptionai/mcp-extension"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-extension": {
      "command": "npx",
      "args": [
        "-y",
        "@kaptionai/mcp-extension"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-extension": {
      "command": "npx",
      "args": [
        "-y",
        "@kaptionai/mcp-extension"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/kaption-whatsapp
