WAHA MCP Server
Provides tools for interacting with WhatsApp via the WAHA HTTP API, enabling messaging, group management, contact lookup, and profile retrieval.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WAHA MCP Server Send 'hello' to 905551234567"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WAHA MCP Server
WhatsApp HTTP API (WAHA) için Model Context Protocol (MCP) server. Claude veya diğer MCP istemcilerini WAHA üzerinden WhatsApp'a bağlar.
Gereksinimler
Node.js 18+
Çalışan bir WAHA instance'ı
Related MCP server: WAHA MCP Server
Kurulum
npm install
npm run buildYapılandırma
Aşağıdaki ortam değişkenleri kullanılır:
Değişken | Varsayılan | Açıklama |
|
| WAHA API base URL |
| (boş) | API anahtarı (WAHA Plus için) |
|
| Kullanılacak oturum adı |
Claude Desktop Entegrasyonu
claude_desktop_config.json dosyanıza ekleyin:
{
"mcpServers": {
"waha": {
"command": "node",
"args": ["/tam/yol/waha-mcp/dist/index.js"],
"env": {
"WAHA_BASE_URL": "http://localhost:3000",
"WAHA_API_KEY": "your-api-key-if-any",
"WAHA_SESSION": "default"
}
}
}
}MCP Inspector ile Test
npx @modelcontextprotocol/inspector node dist/index.jsAraçlar (Tools)
Oturum Yönetimi
Araç | Açıklama |
| Tüm oturumları listele |
Mesajlaşma
Araç | Açıklama |
| Metin mesajı gönder |
| Görsel gönder (URL veya base64) |
| Dosya/belge gönder |
| Mesaja emoji ile tepki ver |
| Mesajı sil |
| Mesajı yıldızla |
Sohbetler & Mesajlar
Araç | Açıklama |
| Sohbet mesajlarını al |
| Sohbet listesini al |
Kişiler
Araç | Açıklama |
| Numara WhatsApp'ta var mı? |
| Kişi bilgisi |
| Kişinin "hakkında" metni |
Gruplar
Araç | Açıklama |
| Grupları listele |
| Grup detayları |
| Grup oluştur |
| Gruptan ayrıl |
| Üye ekle |
| Üye çıkar |
| Grup adını değiştir |
| Grup açıklamasını değiştir |
Profil
Araç | Açıklama |
| Kendi profilini gör |
Chat ID Formatları
Kişisel sohbet:
905551234567@c.usGrup:
120363XXXXXXXX@g.us
Örnek Kullanım
Claude'a: "905551234567 numaralı kişiye 'Merhaba!' yaz"
Claude: waha_send_text(chatId: "905551234567@c.us", text: "Merhaba!")
Claude'a: "Tüm gruplarımı listele"
Claude: waha_get_groups()
Claude'a: "Pazarlama grubuna yeni bir üye ekle: 905559876543"
Claude: waha_add_group_participants(groupId: "120363...@g.us", participants: ["905559876543@c.us"])Available Tools
21 toolswaha_add_group_participantsC
Add participants to a group
Inputs: groupId (required), participants (required).
waha_check_number_existsA
Check if a phone number has a WhatsApp account
Inputs: phone (required).
waha_create_groupB
Create a new WhatsApp group
Inputs: name (required), participants (required).
waha_delete_messageC
Delete a message
Inputs: chatId (required), messageId (required).
waha_get_chatsC
Get list of chats
Inputs: limit, offset.
waha_get_contactA
Get contact info by contact ID
Inputs: contactId (required).
waha_get_contact_aboutB
Get the 'About' status of a contact
Inputs: contactId (required).
waha_get_groupA
Get details of a specific group
Inputs: groupId (required).
waha_get_groupsA
List all groups the session account is in
Inputs: no named parameters.
waha_get_messagesB
Get messages from a chat
Inputs: chatId (required), limit, downloadMedia.
waha_get_my_profileA
Get the profile of the logged-in WhatsApp account
Inputs: no named parameters.
waha_leave_groupB
Leave a WhatsApp group
Inputs: groupId (required).
waha_list_sessionsA
List all WAHA sessions
Inputs: no named parameters.
waha_react_to_messageC
React to a message with an emoji
Inputs: reaction (required), messageId (required).
waha_remove_group_participantsC
Remove participants from a group
Inputs: groupId (required), participants (required).
waha_send_fileB
Send a file/document to a WhatsApp chat via URL
Inputs: url (required), chatId (required), filename (required), mimetype (required), +1 more.
waha_send_imageA
Send an image to a WhatsApp chat via URL or base64
Inputs: chatId (required), url, base64, caption, +2 more.
waha_send_textB
Send a text message to a WhatsApp chat
Inputs: text (required), chatId (required), replyTo.
waha_set_group_descriptionC
Set the group description
Inputs: groupId (required), description (required).
waha_set_group_subjectB
Set the group name/subject
Inputs: groupId (required), subject (required).
waha_star_messageB
Star or unstar a message
Inputs: star (required), chatId (required), messageId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Each tool targets a distinct resource and action, with no overlapping purposes. Message, group, chat, contact, and session operations are clearly separated.
All tools follow the same waha_ verb_noun snake_case pattern, such as send_image, create_group, and get_contact_about. There are no stylistic deviations or mixed conventions.
At 21 tools, the set is slightly above the typical 3-15 range but each operation is distinct and earns its place in a full WhatsApp automation server. The count feels reasonable given the breadth of session, chat, message, contact, and group management.
The tool surface covers all major WhatsApp workflows: messaging, media sending, message reactions, group CRUD, participant management, contact lookup, and profile retrieval. Minor gaps exist (e.g., no mark-as-read, no session start/stop), but these are not critical dead ends for typical automation tasks.
Related MCP Connectors
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
Link a WhatsApp number by QR code and use it from Claude or ChatGPT via MCP.
Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.
Drive WhatsApp from any MCP client: pair devices, send text and media, manage contacts and groups.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables sending WhatsApp messages through Claude Desktop and other MCP-compatible LLMs. Supports single and bulk messaging, phone number validation, and session management via the zapr.link service.MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with WhatsApp through the WAHA (WhatsApp HTTP API) platform. Supports chat management, message operations including sending/receiving messages, and marking chats as read.5211ISC
- AlicenseNot gradedqualityDmaintenanceEnables WhatsApp integration through Evolution API, allowing users to send messages, manage media, track conversations, and control presence status directly from Claude.MIT
- AlicenseAqualityDmaintenanceEnables Claude to interact with WhatsApp through a unified backend API, providing 20 tools for messaging, media, groups, contacts, and chat management.2235 npmMIT