@kahflane/whatsapp-mcp

Name: @kahflane/whatsapp-mcp
Author: kahflane

communication MCP Server

Give your AI agent a WhatsApp account — an MCP server with 87 tools for reading, sending, groups, status, scheduling & more. Works with Claude, Codex, Cursor, OpenCode & any MCP client.

bykahflane

VerifiedInstall Ready

communicationcommunication

5 views3 stars0 forksv0.2.3MIT

View on GitHub Homepage

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 3mo ago.

VerifiedInstall Ready

Source: github-topic:model-context-protocol
Stars: 3
Last synced: 3mo ago
Install: Instructions detected

Install

1. Install the package

npx -y @kahflane/whatsapp-mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "-kahflane-whatsapp-mcp": {
      "command": "npx",
      "args": [
        "@kahflane/whatsapp-mcp"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

Tools

Resources

Prompts

Standard I/O

Transport

Available Tools (26)

WA_DAILY_CAP

`100`

wa_search_messages

Full-text search your history

wa_post_status

Post a story mentioning up to 5 contacts

WA_DATA_DIR

`~/.whatsapp-mcp`

wa_fetch_history

Pull older history (50/call)

wa_post_status_to

Post to a chosen audience (contacts **and** groups) — text with rich backgrounds + fonts, image, video, gif, voice note, audio

wa_logout

Log out and wipe local auth

wa_check_number

Verify numbers are on WhatsApp (anti-ban precheck)

wa_get_group_members

Participants with names + admin flags

wa_restrict_sending

🛑 Kill-switch — block/allow all outbound sends

wa_send_text

Text with mentions / reply / typing

wa_group_participants

Add / remove / promote / demote

Variable

Default

wa_send_media

Image, video, audio, document, sticker

WA_PAIRING_NUMBER

*(empty)*

wa_list_chats

List chats, newest first

wa_send_event

Event card

WA_SYNC_FULL_HISTORY

`true`

wa_get_messages

Read a chat's full messages

wa_reject_call

Reject an incoming call

WA_LOG_LEVEL

`warn`

wa_history_status

Sync progress

Tool

Description

wa_status

Connection, login state, store stats, send counters

wa_download_media

Download + decrypt media to a file

wa_disappearing_chat

Per-chat disappearing-message timer

Works Well With - Skills

c-slack

Send messages and upload files to Slack channels using the `slack` CLI. Supports direct messages, channel posts, file uploads, and thread replies.

4 starsHas guide

c-telegram

Bidirectional Telegram bridge — talk to Claude from your phone. Built into OpenPaw.

4 starsHas guide

mesh-awareness

Discover agents across local node and mesh peers at runtime — their roles, handles, and how to communicate with or delegate to them.

3 starsHas guide

Apply data visualization and storytelling principles from Storytelling with Data by Cole Nussbaumer Knaflic. Covers choosing effective visuals (line, bar, table, scatterplot), eliminating clutter (Gestalt principles, data-ink ratio), focusing attention (preattentive attributes, strategic color), thinking like a designer (affordances, alignment, white space), and narrative structure (three-act story, horizontal/vertical logic, Big Idea). Trigger on "data visualization", "chart design", "dashboard design", "data storytelling", "presentation chart", "declutter chart", "bar chart", "line chart", "data narrative", "slide deck data", "chart review", "viz critique", "storytelling with data".

2 stars

Works Well With - Agents

Awesome Agent Skills For Empirical Research

🔬 A curated collection of 23,000+ agent skills for empirical research across 8 social science disciplines. | 精选 23,000+ AI Agent 技能库，覆盖8大社会科学学科的实证研究。CoPaper.AI 20分钟完成一篇可复现的规范实证论文，并支持用户上传 Skills。-- Maintained by CoPaper.AI from Stanford REAP.

4385 starslangchain

Auto Empirical Research Skills

4108 starslangchain

AgentNetworkProtocol

AgentNetworkProtocol(ANP) is an open source protocol for agent communication. Our vision is to define how agents connect with each other, building an open, secure, and efficient collaboration network for billions of intelligent agents.

1426 stars