About Whatsapp MCP Server
Whatsapp MCP Server is an MCP server published by mattcoatsworth in the Communication category.
The repository has 5 stars and 2 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
From source
git clone https://github.com/mattcoatsworth/Whatsapp-MCP-ServerThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
✦
Ask AI about Whatsapp MCP Server
Powered by Claude · Grounded in docs
I know everything about Whatsapp MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
Static checks derived from the repository yesterday. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
README
WhatsApp Business API MCP Server
A comprehensive Model Context Protocol (MCP) server for interacting with the WhatsApp Business API.
## Features
- Send various types of messages (text, template, media, interactive)
- Manage message templates
- Upload and manage media files
- Update business profile information
- Manage phone numbers
- Configure webhooks
## Prerequisites
- Node.js 16 or higher
- WhatsApp Business API credentials:
- API Token
- Phone Number ID
- Business Account ID
## Installation
```bash
npm install whatsapp-business-mcp-server
```
Or run directly with npx:
```bash
npx whatsapp-business-mcp-server
```
## Configuration
Create a `.env` file with your WhatsApp Business API credentials:
```
WHATSAPP_API_TOKEN=your_api_token_here
WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id_here
WHATSAPP_BUSINESS_ACCOUNT_ID=your_business_account_id_here
WHATSAPP_API_VERSION=v18.0
```
## Usage
### Starting the Server
```bash
npm start
```
### Development Mode
```bash
npm run dev
```
### Using with MCP Inspector
```bash
npm run inspect
```
## Available Tools
### Messaging
- `sendTextMessage` - Send a text message
- `sendTemplateMessage` - Send a template message
- `sendImageMessage` - Send an image
- `sendDocumentMessage` - Send a document
- `sendVideoMessage` - Send a video
- `sendLocationMessage` - Send a location
- `sendContactMessage` - Send contact information
- `sendInteractiveMessage` - Send interactive messages
- `markMessageAsRead` - Mark a message as read
### Media
- `uploadMedia` - Upload media to WhatsApp servers
- `getMediaUrl` - Get the URL for a media file
- `deleteMedia` - Delete media from WhatsApp servers
### Templates
- `getMessageTemplates` - Get message templates
- `createMessageTemplate` - Create a message template
### Business Profile
- `getBusinessProfile` - Get business profile information
- `updateBusinessProfile` - Update business profile
### Phone Numbers
- `getPhoneNumbers` - Get phone numbers
- `getPhoneNumberById` - Get phone number details
- `requestVerificationCode` - Request verification code
- `verifyCode` - Verify a phone number
### Webhooks
- `getWebhookInfo` - Get webhook information
- `subscribeWebhook` - Subscribe to webhooks
- `deleteWebhookSubscription` - Delete webhook subscription
## Available Resources
- `whatsapp://templates` - List all templates
- `whatsapp://templates/{category}` - List templates by category
- `whatsapp://template/{name}` - Get template details
- `whatsapp://business-profile` - View business profile
- `whatsapp://phone-numbers` - List phone numbers
- `whatsapp://phone-number/{id}` - Get phone number details
- `whatsapp://docs` - API documentation
## License
MIT
README fetched from the repository yesterday. The original is authoritative.