whatsapp-mcp

Overview

This MCP server provides comprehensive WhatsApp integration, allowing Claude to search contacts, read and send messages (text, images, videos, documents, and audio), manage chats, and download media. It consists of two components: a Go bridge that connects to WhatsApp and a Python MCP server that exposes the functionality to Claude. All messages are stored locally in SQLite and only shared with Claude when explicitly requested.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• search_contactsquery: string

  Search contacts by name or phone number

  Try:Find contacts named JohnTry:Search for phone number 555-1234Try:Who has the phone number starting with +1?
• get_contactidentifier: string

  Resolve a WhatsApp contact name from a phone number, LID, or full JID

  Try:What's the name for phone number 5551234567?Try:Look up who owns this numberTry:Who is 184125298348272@lid?
• list_messageschat_jid?: string, limit?: number, before_date?: string, after_date?: string, sort_by?: 'newest' | 'oldest'

  Get messages with filters, date ranges, and sorting

  Try:Show me the last 100 messages from todayTry:Get messages from the family group chatTry:Find messages from last week
• send_messagerecipient: string, message: string

  Send a text message to a contact or group

  Try:Send 'Hello!' to +1234567890Try:Message the team group saying 'Meeting at 3pm'
• send_filerecipient: string, file_path: string, caption?: string

  Send a media file (image, video, document)

  Try:Send the document to JohnTry:Send the vacation photo to mom with caption 'Beautiful view!'
• send_audio_messagerecipient: string, file_path: string

  Send a voice message (automatically converts to Opus .ogg format)

  Try:Send a voice message to +1234567890Try:Send an audio note to the team group
• download_mediamessage_id: string, chat_jid: string

  Download media from a received message

  Try:Download the media from message abc123Try:Save the video from the group chat
• list_chatslimit?: number

  List all chats with metadata

  Try:List all my chatsTry:Show me the last 20 chats
• get_chatjid: string

  Get specific chat metadata by JID

  Try:Get info for the family group chatTry:Show details for chat 12025551234@s.whatsapp.net
• get_direct_chat_by_contactphone: string

  Find a direct message chat with a contact

  Try:Find my DM with JohnTry:Get the direct chat with 5551234567
• get_message_contextmessage_id: string, chat_jid: string, before?: number, after?: number

  Get messages around a specific message for context

  Try:Show me messages around message abc123Try:Get context for message xyz456 with 5 messages before and after
• get_last_interactionphone: string

  Get the last message exchanged with a contact

  Try:What was the last message from John?Try:Show me my last conversation with 5551234567

Comparable tools

Installation

FAQ

What type of messages can I read and send?

You can read and send text messages, images, videos, documents, and audio messages. The server also supports voice messages that are automatically converted to Opus .ogg format.

How are messages stored and secured?

All messages are stored locally in SQLite. The bridge uses bearer token authentication for API calls and confines media file access to specified directories. Messages are only sent to Claude when you explicitly allow it.

Compare whatsapp-mcp with