프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요 로그인

WhatsApp MCP

제작자: muhammedanasmithadi버전 0.2.0i★ 0i내 컴퓨터에서 실행저장소 ↗
레지스트리 이름io.github.muhammedanasmithadi/whatsapp-mcp

설치 방법

할 수 있는 일

Self-hosted personal WhatsApp bridge with 86 MCP tools over stdio or Streamable HTTP.

제작자가 쓴 원문

  • 연결 방식 내 컴퓨터에서 실행
  • 계정 또는 키 키 필요 없음
  • 분류 채팅 및 이메일

이 순위인 이유

목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다

인기0/80GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20
최신성12/1230일 안에 릴리스나 코드 변경이 있으면 만점
응답 중0/8마지막 점검 때 클라우드 엔드포인트가 응답
사용 점수12/100

품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

검사 3/3 통과 · 내 컴퓨터에서 실행돼요

먼저: 어떤 AI를 쓰시나요?

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude에 연결할 수 있지만 먼저 준비가 필요해요

키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

  1. 제작자 설치 파일 내려받기

    제작자의 .mcpb 파일 다운로드

    .mcpb 파일은 제작자에게서 바로 온 것으로, 우리는 바꾸지 않았어요

  2. 파일을 두 번 클릭한 뒤 컴퓨터용 Claude 앱에서 Install 누르기

  3. 해 보기

    WhatsApp MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude가 WhatsApp MCP을 쓰고 있다고 하거나 답에 WhatsApp MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

ChatGPT는 아직 WhatsApp MCP에 연결할 수 없어요

WhatsApp MCP는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요

대신 이렇게 할 수 있어요

A · WhatsApp MCP에 연결되는 앱 쓰기

  • 키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

B · 채팅 및 이메일에서 ChatGPT에 연결되는 다른 서버

같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요

Claude Code는 아직 WhatsApp MCP에 연결할 수 없어요

제작자가 컴퓨터용 Claude 앱 설치 파일만 제공해요

대신 이렇게 할 수 있어요

A · WhatsApp MCP에 연결되는 앱 쓰기

  • 키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

Cursor는 아직 WhatsApp MCP에 연결할 수 없어요

제작자가 컴퓨터용 Claude 앱 설치 파일만 제공해요

대신 이렇게 할 수 있어요

A · WhatsApp MCP에 연결되는 앱 쓰기

  • 키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

VS Code는 아직 WhatsApp MCP에 연결할 수 없어요

제작자가 컴퓨터용 Claude 앱 설치 파일만 제공해요

대신 이렇게 할 수 있어요

A · WhatsApp MCP에 연결되는 앱 쓰기

  • 키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? WhatsApp MCP을 쓰는 사람에게 물어보세요💬 토론 →

한눈에 보기

주간 다운로드i
npm/PyPI에 없음
연결 방식
내 컴퓨터에서 실행
최신 버전i
0.2.0
레지스트리 공개i
2026년 11월 20일
코드 마지막 변경i
2026년 11월 20일
제작자
muhammedanasmithadi
패키지
mcpb: …/whatsapp-mcp_0.2.0_darwin_amd64.mcpb
mcpb: …/whatsapp-mcp_0.2.0_darwin_arm64.mcpb
mcpb: …/whatsapp-mcp_0.2.0_linux_amd64.mcpb
웹사이트
github.com
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

내 컴퓨터에서 실행하는 앱

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

모든 앱과 장단점 →

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 20일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 muhammedanasmithadi 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • ✓ 통과

    계속 관리되고 있음

    코드 마지막 변경: 오늘

  • ✓ 통과

    라이선스 있음

    MIT 사용

  • – 해당 없음

    엔드포인트 응답

    내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요

  • – 해당 없음

    OAuth로 로그인

    내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요

  • … 아직 점검 안 함

    도구 설명에 숨겨진 지시 없음

    내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

공개된 취약점 (OSV.dev)

확인 안 함: 버전이 있는 npm과 PyPI 패키지만 확인할 수 있습니다

우리가 확인하는 것 → · JSON

제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/muhammedanasmithadi-whatsapp-mcp.svg)](https://mcp.popnx.com/en/servers/muhammedanasmithadi-whatsapp-mcp)

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

로그인하고 리뷰 쓰기

채팅 및 이메일 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 2046개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 2046개 중 99%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 2046개 중 99%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

WhatsApp MCP, 안전한가요?

해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 오늘 변경됐고, 최신 버전(0.2.0)은 오늘 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 MCPB도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

제작자: anypost널리 사용됨↓ 5.4천/주★ 1.4천6일 전 업데이트

컴퓨터 또는 클라우드✓ 서비스 회사 · emailmd.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

제작자: infobip초기★ 3613개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

제작자: w1ne초기★ 3524일 전 업데이트

클라우드에서 실행✓ 서비스 회사 · kernelcad.com
비슷한 항목과 비교
이 항목
WhatsApp MCP
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
실행 위치컴퓨터에 설치 필요클라우드 또는 컴퓨터 설치 모두 가능클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요
키 필요아니요아니요아니요아니요아니요아니요
Claude에서 +로 추가아니요아니요아니요아니요예아니요
기본 점검3/35/54/44/44/44/4
라이선스MITMITAGPL-3.0Apache-2.0MITMIT
가격등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

WhatsApp MCP

A self-hosted Model Context Protocol (MCP) server that gives an AI agent read and send access to your personal WhatsApp account. It runs on your machine as a single Go binary, speaks MCP over Streamable HTTP at 127.0.0.1:8765/mcp, and keeps your message history in a local SQLite database.

This is an independent, community project. It is not affiliated with, endorsed by, or operated by Meta Platforms, Inc. or WhatsApp LLC.

What it does

Once paired with your phone (the same way you link WhatsApp Web), the daemon:

DomainWhat it does
MessagesRead, search, send, edit, delete, and recover messages; read receipts; mark read; schedule messages; reply; react; poll; contact cards; locations; voice-note transcription
Statuses (Stories)Read, view, post, delete statuses; read receipts; status privacy setting
ProfileRead/set About text, profile photo, contact metadata (About, verified name, LID, linked devices)
PresenceQuery contact online/last-seen; set per-chat typing/recording indicators
GroupsCreate, leave, join via link, participants, name, topic, announce, lock, invite link
ChannelsFollow/unfollow, mute, list, info, messages
ContactsLocal address book (bridge-only; not synced to the phone), search, create, update, delete
Blocklist & PrivacyBlocklist, privacy settings (group add, last seen, status, profile, read receipts, online, calls, messages, defense, stickers)
SchedulingTimer-driven scheduled messages that survive restarts
Auto-responderEvent-driven out-of-office replies to incoming 1:1 text messages
Audit & observabilityAudit log, health check, Prometheus metrics, WebSocket events, SSE pairing events

The daemon exposes 86 MCP tools over Streamable HTTP, serves health (/healthz) and Prometheus metrics (/metrics), and pushes new messages to connected clients over WebSocket (/ws/events).

Architecture

┌─────────────────┐      Streamable HTTP      ┌─────────────────────┐

│ AI agent │◄─────────────────────────►│ whatsapp-mcp │ │ (Claude, etc.) │ /mcp │ MCP server (Go) │ └─────────────────┘ │ • 86 tool handlers │ │ • rate limiting │ │ • SQLite cache │ └──────────┬──────────┘ │ │ whatsmeow multidevice │ protocol (vendored fork) ▼ ┌─────────────────────┐ │ WhatsApp Web │ │ (linked device) │ │ phone ↔ server │ └─────────────────────┘

The daemon wraps whatsmeow, the Go WhatsApp Web multidevice library. Because WhatsApp changes its protocol server-side without notice, the project vendors whatsmeow via a Go replace directive and applies protocol fixes immediately rather than waiting for upstream:

replace go.mau.fi/whatsmeow => ./vendor-whatsmeow/go.mau.fi/whatsmeow

Protocol fixes carried in the fork (also contributed upstream where applicable):

FixWhat it does
SKDM group IDhandleSenderKeyDistributionMessage uses the protobuf groupId, not the enclosing stanza chat, to decide sender-key ownership. This makes statuses and group messages decrypt correctly when retried as direct-to-device SKDMs. Upstream: tulir/whatsmeow#1330
Profile picture tctokenMedia requests include the required token so thumbnails resolve
Presence subscribeMissing id attribute added to presence subscription stanzas
Argo decodingHard-coded failure and macOS early-return removed
SendPresence racePresence updates no longer race with session teardown
GetPrivacySettingsErrors are no longer swallowed
set_status_messageWhatsApp Web calls the xwa2_update_text_status MEX mutation (ID 9152604461510864) first, then the legacy stanza. The MEX mutation is account-gated and fails with a 400 CRITICAL error on accounts without the text-status feature, so it is sent only when an emoji or ephemeral duration is requested; the legacy IQ is always sent
canonicalContactJIDWrong suffix @s.client.net → @s.whatsapp.net fixed

Quick start

Prerequisites
  • Go 1.26+ (build-time only; runtime needs just the compiled binary)
  • FFmpeg (optional, for voice-note transcoding via send_audio_message)
  • An MCP client that speaks HTTP (Claude Desktop, Cursor, Claude Code, OpenCode, etc.)
Build

Download a prebuilt binary from the latest release. Release assets cover Linux (amd64, arm64), macOS (amd64, arm64) and Windows (amd64), with SHA-256 sums in checksums.txt. The binary needs no runtime dependencies except FFmpeg for voice-note transcoding.

Or build from source:

git clone https://github.com/muhammedanasmithadi/whatsapp-mcp.git

cd whatsapp-mcp make build # writes ./bin/whatsapp-mcp

Pair your phone

Start the daemon, then open the pairing page:

./bin/whatsapp-mcp serve          # starts on 127.0.0.1:8765

Visit http://127.0.0.1:8765/pair, scan the QR code with WhatsApp (Settings → Linked Devices → Link a Device), and the session persists to ./store/whatsapp.db. WhatsApp rotates the session roughly every 20 days; the daemon re-pairs automatically with exponential backoff.

No browser? Run ./bin/whatsapp-mcp login to render the QR in the terminal, or use the phone-number form on /pair.

Connect your MCP client

Add this to your client configuration:

// OpenCode (opencode.jsonc), Claude Code, Cursor, etc.

{ "mcpServers": { "whatsapp": { "type": "http", "url": "http://127.0.0.1:8765/mcp" } } }

Restart your client. The daemon outlives client restarts.

One-click install with MCPB

Each release also ships a .mcpb bundle for Linux, macOS and Windows. Install the bundle matching your platform in an MCPB-capable desktop client; the client starts the binary over stdio and fills in the configuration for you.

Pair once before installing the bundle, because stdio mode has no browser to show a QR code:

whatsapp-mcp -store ~/.whatsapp-mcp login

The bundle's store_dir setting defaults to ~/.whatsapp-mcp, and its read_only setting maps to WHATSAPP_MCP_READ_ONLY. To run stdio mode by hand:

whatsapp-mcp -store ~/.whatsapp-mcp stdio -read-only

stdout carries JSON-RPC frames only; every diagnostic goes to stderr.

Serve flags and environment

Flag / env varDefaultPurpose
-addr / WHATSAPP_MCP_ADDR127.0.0.1:8765HTTP bind address
-allow-remoteoffBind to a non-loopback address (requires WHATSAPP_MCP_TOKEN)
WHATSAPP_MCP_TOKEN—Bearer token for /mcp and /pair/* when remote-bound
-read-only / WHATSAPP_MCP_READ_ONLYoffExpose only read/query tools (no send, edit, delete, mark-read, group, blocklist, privacy, status-change tools)
-log-format / WHATSAPP_MCP_LOG_FORMATtexttext for human logs; json for structured JSON lines
WHATSAPP_MCP_MEDIA_ROOT /uploads/File allowlist root for send/download tools
WHATSAPP_MCP_DEVICE_NAMEWhatsApp MCPName shown for this device in WhatsApp → Linked Devices
WHATSAPP_MCP_FULL_HISTORY_SYNCoffBackfill older messages for all cached chats after pairing
-debug / WHATSAPP_MCP_DEBUGoffVerbose (unredacted) logs
Observability
  • GET /healthz — JSON: connected, paired, state, uptime_sec
  • GET /metrics — Prometheus text format: messages in/out, sends, errors, rate-limited, pairing state, uptime
Real-time push
  • WS /ws/events — WebSocket broadcast of new-message events as JSON
  • GET /pair/events — Server-Sent Events stream of pairing state transitions

MCP tools reference

The server exposes 86 tools, grouped by domain:

Messaging
ToolDescription
send_messageSend a text message to a person or group
send_fileUpload and send a picture, video, document, or attachment
send_audio_messageSend an audio file as a voice note (transcodes via ffmpeg if needed)
send_locationSend a map location
send_contact_cardSend a contact card (vCard)
send_pollSend a poll with 2–32 options
send_poll_voteCast a vote on a poll
send_reactionAdd or replace an emoji reaction on a message
send_replySend a reply that quotes a previous message
edit_messageEdit the text of a sent message
delete_messageRevoke (delete) a sent message
recover_mediaRequest WhatsApp to re-send media for a message
transcribe_voice_noteTranscribe a voice note via the configured STT endpoint
batch_send_messagesSend multiple messages in one call
Statuses (Stories)
ToolDescription
list_status_updatesList cached Status updates grouped by sender
mark_status_viewedSend read receipts for a contact's statuses
send_statusPost a Status update (image/video + caption)
delete_statusDelete one of your own status updates
get_status_viewersViewers of a status (WhatsApp does not expose this to linked devices; returns empty list with a note)
set_status_privacy_settingSet who can see your statuses (all, contacts, close_friends, custom)
Profile & presence
ToolDescription
get_contact_infoLive profile metadata (About, profile-picture ID, LID, devices, business verification)
get_profile_pictureFetch a contact's or group's profile photo
set_profile_pictureSet the paired account's profile photo
set_status_messageSet the About text shown in the profile
get_presenceQuery a contact's online/last-seen state
send_typingShow or hide per-chat typing/recording indicator
send_presenceSet global online/offline availability
Groups
ToolDescription
create_groupCreate a group with participants
leave_groupLeave a group
join_group_with_linkJoin a group via invite link
get_group_infoGet group metadata
get_group_invite_linkGet or reset a group invite link
set_group_nameRename a group
set_group_topicSet group topic/description
set_group_announceSet announce-only mode
set_group_lockedLock/unlock a group
update_group_participantsAdd/remove/promote/demote participants
mute_chatMute/unmute a chat
pin_chatPin/unpin a chat in the chat list
Channels
ToolDescription
list_channelsList followed WhatsApp Channels
follow_channelFollow a channel
unfollow_channelUnfollow a channel
mute_channelMute/unmute a channel
get_channel_infoGet channel metadata
list_channel_messagesList messages from a channel
Contacts
ToolDescription
list_contactsList local address-book contacts
create_contactCreate a local contact entry
update_contactUpdate a local contact

| delete_contact | Delete a

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요