Loading...
{
"mcpServers": {
"whatsapp": {
"command": "{{PATH_TO_UV}}", // Run `which uv` and place the output here
"args": [
"--directory",
"{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server", // cd into the repo, run `pwd` and enter the output here + "/whatsapp-mcp-server"
"run",
"main.py"
]
}
}
}search_contactsSearches for contacts by name or phone number.
Read-only operation, no side effects.
list_messagesRetrieves messages with optional filters and context.
Read-only operation, no side effects.
list_chatsLists available chats with metadata.
Read-only operation, no side effects.
get_chatGets information about a specific chat.
Read-only operation, no side effects.
get_direct_chat_by_contactFinds a direct chat with a specific contact.
Read-only operation, no side effects.
get_contact_chatsLists all chats involving a specific contact.
Read-only operation, no side effects.
get_last_interactionGets the most recent message with a contact.
Read-only operation, no side effects.
get_message_contextRetrieves context around a specific message.
Read-only operation, no side effects.
send_messageSends a WhatsApp message to a specified phone number or group JID.
Sends messages, potentially leading to unintended actions.
send_fileSends a file (image, video, raw audio, document) to a specified recipient.
Sends files, potentially leading to unintended sharing of sensitive information.
send_audio_messageSends an audio file as a WhatsApp voice message.
Sends audio messages, potentially leading to unintended sharing of sensitive information.
download_mediaDownloads media from a WhatsApp message and gets the local file path.
Downloads media to local storage, potentially exposing sensitive content.
This server offers convenient access to WhatsApp data but requires careful management of tool permissions to mitigate the risk of unintended actions or data exfiltration. It is safer for read-only operations but becomes riskier when message sending and file operations are enabled. Regular security audits and monitoring are recommended.