Whatsapp-MCP-Server

# 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