Skip to content

Whatsapp MCP

Caution

An MCP server for searching your personal WhatsApp messages, contacts and sending messages to individuals or groups

by lharries 5,411 MIT Go Intermediate stdio

Install

No auto-install command available for this server.

Check the GitHub repository for setup instructions

Safety Report

43% Caution
Scanned yesterday
3 passed 4 warnings
Security
Authentication
details

QR code authentication links to a personal WhatsApp account. Re-authentication required approximately every 20 days. No API key or token-based auth.

Warning
CORS Policy
details

Runs as local Go + Python bridge; no HTTP server exposed, CORS not applicable.

N/A
Rate Limiting
details

No rate limiting documented. WhatsApp may throttle or ban accounts for automated messaging abuse.

Warning
Known CVEs
details

README explicitly warns: 'Prompt injection could lead to private data exfiltration' due to MCP architecture risks.

Warning
Code Quality
Dependency Audit
details

Uses unofficial WhatsApp web multidevice API (go-whatsapp library). Not endorsed by Meta/WhatsApp; TOS risk.

Warning
Dangerous Patterns
details

No dangerous code patterns detected

Pass
License
details

MIT license.

Pass
Code Source
details

Open source on GitHub. Go bridge and Python MCP server both publicly auditable.

Pass
Community
Maintenance Status
details

Community project by individual developer. Maintenance cadence not guaranteed.

Info

Learn about our security methodology →

Compatibility

Claude CodeConfigured via JSON config; requires local Go bridge running.
Not Tested
CursorSupported via MCP config file.
Not Tested
VS CodeWorks via standard MCP stdio transport.
Not Tested
WindsurfNo documented direct integration but standard MCP transport should work.
Partial
Claude DesktopPrimary documented target; configured via claude_desktop_config.json.
Not Tested

Tools Provided (12)

search_contacts

Find contacts by name or phone number.

list_messages

Retrieve messages from a chat with optional filters and context window.

list_chats

Display available chats with metadata.

get_chat

Get information about a specific chat by ID.

get_direct_chat_by_contact

Find the direct chat associated with a specific contact.

get_contact_chats

List all chats that involve a specific contact.

get_last_interaction

Fetch the most recent message exchanged with a contact.

get_message_context

Get messages surrounding a specific message for context.

send_message

Send a WhatsApp text message to an individual or group.

send_file

Share images, videos, documents, or raw audio files via WhatsApp.

send_audio_message

Send audio as a WhatsApp voice message.

download_media

Download media from a message and return the local file path.

Frequently Asked Questions

What is Whatsapp MCP?

An MCP server for searching your personal WhatsApp messages, contacts and sending messages to individuals or groups

What tools does Whatsapp MCP provide?

Whatsapp MCP provides 12 tools including search_contacts, list_messages, list_chats, get_chat. Each tool can be called by AI agents to perform specific operations.

Is Whatsapp MCP safe to use?

Whatsapp MCP is rated Caution. Some security checks raised warnings. Review the safety report on this page for details before use.

What are alternatives to Whatsapp MCP?

Similar MCP servers include Slack MCP Server, Telegram MCP, Ms 365 MCP Server. Each serves a similar purpose but may differ in features, language, and compatibility.

Similar MCP Servers