--- title: "Export WhatsApp contacts with Cursor" description: "Ask Cursor to export your WhatsApp contacts or a chat as CSV or JSON, or list the members of a group. Setup in 3 steps, prompts to copy, limits and privacy." canonical: "https://kaptionai.com/mcp/cursor/export-whatsapp-contacts/" lang: "en" --- # Export WhatsApp contacts with Cursor > Ask Cursor to export your WhatsApp contacts or a chat as CSV or JSON, or list the members of a group. Setup in 3 steps, prompts to copy, limits and privacy. Canonical: https://kaptionai.com/mcp/cursor/export-whatsapp-contacts/ Ask Cursor 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 Cursor shows it as a table or text you can save. ## How do I export my WhatsApp contacts with Cursor? Connect WhatsApp to Cursor 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 Cursor 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 Cursor? 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 Cursor. Setup takes three steps: 1. **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 Cursor works. 2. **Install the server in Cursor.** Click Add to Cursor on the setup page, or add https://mcp.kaptionai.com/mcp as a server named whatsapp in ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project). 3. **Sign in and ask the agent.** Enter your phone number and the 6-digit code Kaption sends you on WhatsApp. Then ask the agent in Cursor’s chat; there is no API key to paste. MCP server address: `https://mcp.kaptionai.com/mcp` (Streamable HTTP, OAuth 2.1). Full Cursor setup guide: https://kaptionai.com/mcp/cursor/ ## What should I ask Cursor? Copy a prompt, paste it into Cursor 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 saved contacts as JSON with name and phone and save it as contacts.json in this project. ## What can Cursor 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 in VS Code, Windsurf, Zed and other editors with remote MCP and OAuth, at the same address. For a local connection, use npx -y @kaptionai/mcp-extension@latest (Node.js 18 or newer). ### 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 Cursor, 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 Cursor, 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: https://kaptionai.com/pricing/ ([pricing.md](https://kaptionai.com/pricing.md)). ## 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 Cursor 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 Cursor. 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. Cursor can download a single photo, document or voice note from a message if you ask. ### Does it work in VS Code too? Yes. The Cursor setup page has an Add to VS Code button, and any editor that supports remote MCP servers with OAuth can use the same address. ## Related - [Encrypted WhatsApp backups](https://kaptionai.com/backups/) - [Export contacts and chats in Claude](https://kaptionai.com/mcp/claude/export-whatsapp-contacts/) - [Export contacts and chats in ChatGPT](https://kaptionai.com/mcp/chatgpt/export-whatsapp-contacts/) - [Full Cursor setup guide](https://kaptionai.com/mcp/cursor/)