WhatsApp MCP
Connects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
What is WhatsApp MCP?
WhatsApp MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to connects ai assistants to the official meta whatsapp cloud api for managing conversations and sending various message types through natural language. it provides tools for media management, template m...
Connects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Connects AI assistants to the official Meta WhatsApp Cloud A
Use Cases
Maintainer
Works with
Installation
NPM
npx -y whatsappManual Installation
npx -y whatsappConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WhatsApp MCP
The WhatsApp MCP Server connects AI assistants to the official Meta WhatsApp Cloud API, enabling them to send and receive messages, manage media, handle template messages, and update business profiles through natural language. Unlike reverse-engineered alternatives, it uses Meta's official API so there is no ban risk. Developers use it to build AI-driven customer support bots, notification systems, and conversational workflows on WhatsApp without writing custom API integration code.
Prerequisites
- Node.js 18+ and npm/npx installed
- A Meta Developer account with a WhatsApp Business app created at developers.facebook.com
- A verified WhatsApp Business phone number with an assigned Phone Number ID
- A permanent WhatsApp access token from the Meta dashboard
- An MCP-compatible client such as Claude Desktop
Set up a Meta WhatsApp Business app
Log in to developers.facebook.com, create a new app of type 'Business', and add the WhatsApp product. Note your Phone Number ID and generate a permanent access token from the app dashboard.
Collect your credentials
Gather the four required values from your Meta dashboard: Phone Number ID, Access Token, Webhook Verify Token (a secret string you choose), and optionally your App Secret for production use.
Test the server locally
Run the server once via npx to verify your credentials work before adding it to your MCP client configuration.
WHATSAPP_PHONE_NUMBER_ID=your_id WHATSAPP_ACCESS_TOKEN=your_token npx -y @fredshred7/whatsapp-mcp-serverAdd the server to your MCP client configuration
Edit your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS) to add the WhatsApp server with your real credentials.
{
"mcpServers": {
"whatsapp": {
"command": "npx",
"args": ["-y", "@fredshred7/whatsapp-mcp-server"],
"env": {
"WHATSAPP_PHONE_NUMBER_ID": "your_phone_number_id",
"WHATSAPP_ACCESS_TOKEN": "your_permanent_access_token",
"WHATSAPP_WEBHOOK_VERIFY_TOKEN": "your_webhook_secret",
"WHATSAPP_APP_SECRET": "your_meta_app_secret"
}
}
}
}Restart your MCP client and verify the connection
Restart Claude Desktop (or your chosen client) to load the new server. Ask your AI assistant to send a test WhatsApp message to confirm the connection is working.
WhatsApp MCP Examples
Client configuration
Full Claude Desktop configuration for the WhatsApp MCP server using the official Meta Cloud API.
{
"mcpServers": {
"whatsapp": {
"command": "npx",
"args": ["-y", "@fredshred7/whatsapp-mcp-server"],
"env": {
"WHATSAPP_PHONE_NUMBER_ID": "123456789012345",
"WHATSAPP_ACCESS_TOKEN": "EAAxxxxxxxxxxxxx",
"WHATSAPP_WEBHOOK_VERIFY_TOKEN": "my_secret_token",
"WHATSAPP_APP_SECRET": "abc123def456"
}
}
}
}Prompts to try
Send messages, manage media, and handle templates through natural language once the server is connected.
- "Send a WhatsApp message to +1234567890 saying 'Your order has shipped'"
- "Upload the invoice.pdf to WhatsApp media storage and get its media ID"
- "Send a template message using the 'order_confirmation' template to +1234567890"
- "Update my WhatsApp business profile description to 'Open Mon-Fri 9am-5pm'"Troubleshooting WhatsApp MCP
Messages fail with 'Invalid OAuth access token' error
Ensure you are using a permanent access token, not the temporary 24-hour token shown in the Meta dashboard's 'Try the API' section. Generate a permanent token via System Users in Meta Business Manager.
Webhook verification fails when registering with Meta
The WHATSAPP_WEBHOOK_VERIFY_TOKEN in your config must exactly match the Verify Token you enter in the Meta dashboard Webhook setup. Also ensure your webhook URL is publicly accessible — use ngrok for local development.
Template messages are rejected with 'template not found'
Template names are case-sensitive and must be pre-approved in your WhatsApp Business Manager. Verify the template exists and its status is 'Approved' before attempting to send it via the MCP server.
Frequently Asked Questions about WhatsApp MCP
What is WhatsApp MCP?
WhatsApp MCP is a Model Context Protocol (MCP) server that connects ai assistants to the official meta whatsapp cloud api for managing conversations and sending various message types through natural language. it provides tools for media management, template messages, and real-time webhook processing without It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WhatsApp MCP?
Install via npm with the command: npx -y whatsapp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with WhatsApp MCP?
WhatsApp MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WhatsApp MCP free to use?
Yes, WhatsApp MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
WhatsApp MCP Alternatives — Similar Communication Servers
Looking for alternatives to WhatsApp MCP? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Md2WeChat
★ 2.3kMarkdown to WeChat CLI | 一键排版发布到微信公众号：支持 40+ 排版样式和专业主题 、AI 配图 、批量发布
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up WhatsApp MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use WhatsApp MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.