Skip to main content
Glama
WAHA MCP Server

WAHA MCP Server

by yusufekorman

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 build

Yapılandırma

Aşağıdaki ortam değişkenleri kullanılır:

Değişken

Varsayılan

Açıklama

WAHA_BASE_URL

http://localhost:3000

WAHA API base URL

WAHA_API_KEY

(boş)

API anahtarı (WAHA Plus için)

WAHA_SESSION

default

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.js

Araçlar (Tools)

Oturum Yönetimi

Araç

Açıklama

waha_list_sessions

Tüm oturumları listele

Mesajlaşma

Araç

Açıklama

waha_send_text

Metin mesajı gönder

waha_send_image

Görsel gönder (URL veya base64)

waha_send_file

Dosya/belge gönder

waha_react_to_message

Mesaja emoji ile tepki ver

waha_delete_message

Mesajı sil

waha_star_message

Mesajı yıldızla

Sohbetler & Mesajlar

Araç

Açıklama

waha_get_messages

Sohbet mesajlarını al

waha_get_chats

Sohbet listesini al

Kişiler

Araç

Açıklama

waha_check_number_exists

Numara WhatsApp'ta var mı?

waha_get_contact

Kişi bilgisi

waha_get_contact_about

Kişinin "hakkında" metni

Gruplar

Araç

Açıklama

waha_get_groups

Grupları listele

waha_get_group

Grup detayları

waha_create_group

Grup oluştur

waha_leave_group

Gruptan ayrıl

waha_add_group_participants

Üye ekle

waha_remove_group_participants

Üye çıkar

waha_set_group_subject

Grup adını değiştir

waha_set_group_description

Grup açıklamasını değiştir

Profil

Araç

Açıklama

waha_get_my_profile

Kendi profilini gör

Chat ID Formatları

  • Kişisel sohbet: 905551234567@c.us

  • Grup: 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 tools
waha_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

    B3.3/5.0

    Scored across 21 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action, with no overlapping purposes. Message, group, chat, contact, and session operations are clearly separated.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      52
      11
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      Enables Claude to interact with WhatsApp through a unified backend API, providing 20 tools for messaging, media, groups, contacts, and chat management.
      22
      35 npm
      MIT