MCP · Claude

Export WhatsApp contacts with Claude

Ask Claude for your WhatsApp contacts as CSV, the members of a group, or a chat’s messages as a file. Kaption builds the export on your computer and Claude shows it as a table or text you can save.

MCP server address

https://mcp.kaptionai.com/mcp

Short answer

How do I export my WhatsApp contacts with Claude?

Connect WhatsApp to Claude with Kaption’s MCP server and ask “export my saved WhatsApp contacts as CSV”. Kaption builds the list from WhatsApp on your computer, deduplicated by phone number and sorted by name, and Claude returns it. It can also list a group’s members or export a chat’s messages as CSV, JSON or text. It is unlimited in your first 60 days; after that it uses your plan’s monthly credits.

What do I need to do this in Claude?

Kaption open on your computer (the extension in WhatsApp Web, in Chrome or Edge, or the Kaption desktop app) with Cloud MCP on, a Kaption account (every account starts with 60 days of Business, unlimited; after that, a plan with credits), and Claude. Setup takes three steps:

  1. 01

    Turn on Cloud MCP in Kaption

    In WhatsApp Web with the Kaption extension (Chrome or Edge), open AI Assistants (MCP) › Cloud Bridge › Enable. In the Kaption desktop app, switch on Cloud MCP in Settings. Keep Kaption open while Claude works.

  2. 02

    Add the connector in Claude

    Go to Customize › Connectors, click + Add › Add custom connector, name it WhatsApp and paste https://mcp.kaptionai.com/mcp.

  3. 03

    Sign in and switch it on

    Enter your phone number and the 6-digit code Kaption sends you on WhatsApp. Then, in a Claude chat, click + › Connectors and turn WhatsApp on.

Full Claude setup guide →

What should I ask Claude?

Copy a prompt, paste it into Claude and change the names to your own chats and contacts.

  • Export my saved WhatsApp contacts as CSV with name and phone.

  • List everyone in the Parents group with their phone numbers, as a table.

  • Which groups is Martín in with me?

  • Export my chat with the accountant from this month as text, with the voice-note transcripts.

  • Export my contacts as CSV and list the ones that have no saved name.

What can Claude do here, and what can’t it?

It can

  • Export all your WhatsApp contacts as CSV or JSON, deduplicated by phone number and sorted by name, with only the fields you want.
  • Filter the export to saved contacts, or by a name or number.
  • List your groups, a group’s current members, and the groups a contact is in with you.
  • Export a chat’s messages as CSV, JSON or text, with voice-note transcripts, in parts of up to 500 messages.
  • Work on Claude Free, Pro, Max, Team and Enterprise. Free can add one custom connector, which is enough for Kaption.
  • Work in Claude Code too: claude mcp add --transport http whatsapp https://mcp.kaptionai.com/mcp

It can’t

  • Restore chats or move them to another phone. For an encrypted copy of all your chats, use Kaption Backups.
  • Include WhatsApp’s private @lid identifiers: only contacts with a real phone number are exported.
  • Export locked chats.
  • Import contacts into WhatsApp or add people to groups.

What leaves my computer?

The export is built in Kaption on your computer from WhatsApp’s data. The list or messages are then sent to Claude, so the names and phone numbers in it leave your computer at that point. Export only what you need.

Kaption’s relay at mcp.kaptionai.com checks your sign-in and passes each request to Kaption on your computer, which runs it against your WhatsApp and sends back only the answer; the relay does not keep your chats. What comes back, such as message text, names and numbers, goes to Claude, which handles it under its own privacy terms. Locked chats are never visible to the assistant, and you can disconnect at any time.

How many credits does my plan include?

Claude and ChatGPT are unlimited in every account’s first 60 days; after that they need a plan, counted in credits per calendar month: Lifetime local AI 50, Pro 250, and Business 500 with its 2 numbers plus 250 for each extra number, shared by all its numbers, the plan to pick when an assistant uses WhatsApp every day. Business Agent includes them with fair use. A read uses 1 credit, a send 2 and a summary 3. See plans and prices

Questions

Which fields are in the contacts export?

Up to six: the WhatsApp ID, phone number, saved name, the name the person set in WhatsApp, whether they are a saved contact, and whether the account is a business. Ask Claude for only the ones you need.

Is this the same as a backup?

No. An export is a one-off list or file that goes to Claude. Kaption Backups keeps an encrypted copy of all your chats in a folder you choose, and nothing goes to an assistant.

Can I export a whole chat with its photos?

The chat export has the messages and voice-note transcripts, not the media files. Claude can download a single photo, document or voice note from a message if you ask.

Do I need a paid Claude plan?

No. Claude Free can add one custom connector, which is enough for Kaption. On Team and Enterprise, an owner adds the connector once in Organization settings › Connectors and each member clicks Connect.

Connect WhatsApp to Claude

Turn on Cloud MCP in Kaption, add the address to Claude and sign in with a code on WhatsApp.

Set up WhatsApp in Claude
Transcribe one audio now