---
title: "Kaption WhatsApp MCP server"
description: "Connect WhatsApp to Claude, ChatGPT, Cursor or any MCP client. The AI assistant can search chats, summarize conversations, look up contacts, manage reminders, schedule messages and, if the user allows it, send them, with OAuth sign-in and access the user can revoke."
canonical: "https://kaptionai.com/mcp/"
lang: "en"
---

# Kaption WhatsApp MCP server

> Connect WhatsApp to Claude, ChatGPT, Cursor or any MCP client. The AI assistant can search chats, summarize conversations, look up contacts, manage reminders, schedule messages and, if the user allows it, send them, with OAuth sign-in and access the user can revoke.

Canonical: https://kaptionai.com/mcp/

## Cloud connection (remote MCP)

- Endpoint (Streamable HTTP): `https://mcp.kaptionai.com/mcp` (SSE: `https://mcp.kaptionai.com/sse`)
- Auth: OAuth 2.1 with PKCE (S256) and dynamic client registration. Scope: `kaption:access`. Protected resource metadata: https://mcp.kaptionai.com/.well-known/oauth-protected-resource
- Sign-in: phone number plus a 6-digit code sent on WhatsApp. Connection lifetime: while in use (ends after 90 days without use), 1 year, or until disconnected. Access tokens last one hour.

Setup:
1. Open WhatsApp Web in Chrome or Edge with the Kaption extension, or the Kaption desktop app, signed in to Kaption.
2. Extension: AI Assistants (MCP) › Cloud Bridge › Enable. Desktop app: Settings › Cloud MCP. In Kaption 0.95 and later: open AI assistants, click Add an assistant and choose Claude or ChatGPT.
3. Add the endpoint to the AI app as a remote MCP server / custom connector.
4. Sign in.

## Local connection (stdio)

Requires Node.js 18+. Turn on the MCP bridge in the extension (or Local MCP in the desktop app) and keep WhatsApp Web open.

Claude Code:

```bash
claude mcp add whatsapp -- npx -y @kaptionai/mcp-extension@latest
```

JSON config (Claude Desktop, Cursor and other clients):

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

Package: https://www.npmjs.com/package/@kaptionai/mcp-extension

## Tools (cloud)

- Read-only: `query`, `download_media`, `list_contacts`, `get_contact`, `get_contact_groups`, `list_groups`, `get_group`, `export_contacts`, `get_analytics`, `call_recordings` (recordings made with the Kaption extension in Chrome or Edge; desktop app recordings are not included yet)
- Writes a private summary: `summarize_conversation`
- Organize: `manage_labels`, `manage_notes` (WhatsApp Business), `manage_chat` (archive, pin, mute, read/unread, draft), `manage_reminders`, `manage_lists`
- Schedules a message to one 1:1 chat (≤800 characters): `manage_scheduled_messages`
- Sends a message from the user's computer, on by default unless the user turned off "Let assistants send messages from this computer" in Kaption for that WhatsApp account: `send_message` (an existing person chat or eligible group; at most one image, document, audio or video attachment, 8 MiB; queued for the earliest permitted delivery; 8 an hour and 20 a day, plus group limits and delays)

## Limits

- Nothing is sent instantly: `send_message` queues the message, and "queued" is not proof of delivery. The computer and WhatsApp must stay open.
- From Kaption 0.94, sending is on by default and Kaption shows a one-time notice the first time an assistant sends. The user can turn it off at any time in Kaption → AI assistants → Connections, which also stops messages scheduled from this computer; an explicit off stays off, and an assistant cannot change the setting. Confirm the text and the recipient with the user before sending.
- Locked chats are never visible.
- Works only while Kaption (extension in WhatsApp Web, or desktop app) is open; otherwise tools return "Extension not connected".
- Bulk or unsolicited messaging is forbidden by the terms; access is rate-limited.

## Trust

- Off by default; revocable any time.
- The relay forwards requests and answers and cannot read messages. Source: https://github.com/Kaption-AI/mcp-extension-remote. Deploys are Sigstore-signed and recorded in a public hash-chained log.
- Reminders and scheduled messages are stored in Kaption Cloud; messages are not.
- Claude and ChatGPT are unlimited in every Kaption account’s first 60 days; after that they need a plan, counted in credits per calendar month: Lifetime local AI 50; Pro 250; Business 500 for its 2 numbers plus 250 per extra number, shared by all its numbers; Business Agent included with fair use. A read uses 1 credit, a change 1, a send 2, a summary 3, an export or call recording 5; settings and help are free. Listing tools and connecting do not count, and a failed action gives its credits back. See https://kaptionai.com/pricing/

Guide: https://kaptionai.com/blog/en/connect-whatsapp-to-claude-chatgpt-mcp/