Whatsapp Mcp

Name: Whatsapp Mcp
Author: lharries

communication MCP Server

WhatsApp MCP server

bylharries

FreshInstall Ready

communicationcommunication

8 views6,524 stars1,382 forksMIT

View on GitHub Homepage Docs

Why This Matters

Discovered via unknown and last synced Today.

FreshInstall Ready

Source: unknown
Stars: 6,524
Last synced: Today
Install: Instructions detected

Install

1. Add to claude_desktop_config.json

{
  "mcpServers": {
    "whatsapp-mcp": {
      "command": "uvx",
      "args": [
        "adelaidasofia-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 (88)

Variable

Default

FORWARD_SELF

`true`

WHATSAPP_DB_PATH

`$HOME/.claude/whatsapp-mcp/store/messages.db`

WHATSAPP_API_URL

`http://localhost:8080/api`

WHATSAPP_SCRUB_PROMPT_INJECTION

`true`

WHATSAPP_AUDIT_LOG

`true`

WHATSAPP_ENCRYPT_DB

`true`

WHATSAPP_MEDIA_PATH

`$HOME/.claude/whatsapp-mcp/media/`

WHATSAPP_WHISPER_MODEL

`large-v3`

whatsapp_get_contact_info

Get contact details

WHATSAPP_WHISPER_API_KEY

empty

send_message

Send WhatsApp messages

list_chats

Browse conversations

Tools

C1[list_chats get_chat_messages search_messages find_chat send_message load_more_messages get_my_info] C -->

send

D D -->

find_chat

Locate chat by name

search_messages

Search across all chats

get_my_info

Get your profile info

Resources

C3[Workflow Guides Search Patterns JID Format] C1 -.->

get_chat_messages

Read specific chat

load_more_messages

Fetch older history

whatsapp_leave_group

Leave a group

whatsapp_send_message

Send text, reply, or media messages

delete_template

Delete a template by name

X-Meta-Phone-Number-Id

Yes

Package

Purpose

check_template_status

Quick status check for a template

X-Meta-Access-Token

Yes

get_template_detail

Get full details of a template by ID

Header

Required

Catalog

✅

send_template_message

Send an approved template to a phone number

X-Meta-Business-Account-Id

Yes

mcp

Model Context Protocol SDK

validate_template

Validate a template payload before submitting to Meta

Transport

Command

X-Meta-Api-Version

pydantic

Payload validation

send_bulk_template_messages

Send an approved template to multiple phone numbers

X-Meta-App-Id

httpx

Async HTTP client for Meta API

create_template

Submit a template for Meta approval

sse

`python -m whatsapp_mcp --transport sse`

Create

Send

python-dotenv

Environment config

list_templates

List templates with optional filters (status, category, name)

streamable-http

`python -m whatsapp_mcp --transport streamable-http`

Carousel

✅

whatsapp_read_messages

Read messages from a chat

whatsapp_create_group

Create a new group

whatsapp_setup

Manage profiles (add, remove, switch, scan Chrome, clone session)

whatsapp_react

React to a message with an emoji

whatsapp_download_media

Download media attachments

whatsapp_list_chats

List recent chats with unread counts

whatsapp_get_group_info

Get group details and participants

whatsapp_search_chats

Search chats by name or number

whatsapp_group_add_participants

Add members to a group

whatsapp_forward_message

Forward a message to another chat

whatsapp_status

Connection status, uptime, platform info

whatsapp_group_remove_participants

Remove members from a group

WHATSAPP_BRIDGE_TOKEN

generated in `whatsapp-bridge/store/.bridge-token`

false

Request full history at pair time. Only takes effect on a fresh pair (no existing `whatsapp.db`); no-op for already-paired sessions. The phone ultimately decides the actual history window sent — see [Requesting full history](#requesting-full-history) below.

WHATSAPP_MEDIA_ROOTS

`~/.local/share/whatsapp-mcp/outbox`

WHATSMEOW_DB_PATH

`../whatsapp-bridge/store/whatsapp.db`

Flag

Default

WEBHOOK_URL

`http://localhost:8769/whatsapp/webhook`

Read

DB GO -->

Canonical

This implementation

WHATSAPP_WHISPER_BACKEND

`off`

WHATSAPP_VAULT_CRM_PATH

empty

None

`govulncheck` + `pip-audit` + Dependabot, daily

Tool

Purpose

POST

EXT ``` ### Component Details ```mermaid flowchart LR subgraph GoAPI["Go Bridge REST API"] direction TB SEND["/api/send"] DOWN["/api/download"] REACT["/api/react"] TYPE["/api/typing"] HEALTH["/api/health"] end subgraph MCPTools["MCP Tools (14 total)"] direction TB CONT["Contact Tools search_contacts, get_contact"] MSG["Message Tools list_messages, send_message, etc."] CHAT["Chat Tools list_chats, get_chat, etc."] MEDIA["Media Tools send_file, download_media, etc."] end MCPTools -->

WebSocket

WA GO -->

WHATSAPP_BRIDGE_PORT

`8080`

event_type

string

source_url

Destination URL of the ad

Field

Description

id

string (UUID)

source_id

The ad ID that originated the conversation

source_type

Ad placement type (e.g. `AD`)

string

Local contact name for the sender (omitted if empty)

bool

`true` if the message is in a group chat

ctwa_clid

Meta's click ID — use this for offline conversion attribution via Meta Conversions API

null

Present when message originated from a Meta Click-to-WhatsApp ad (see below)

timestamp

string (RFC3339)

headline

Ad creative headline text

WHATSAPP_DB_KEY

empty

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

storytelling-with-data

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.

1441 stars