Back to Browse

Whatsapp MCP Server

CommunicationLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Connect a personal/Business WhatsApp account via QR pairing (multi-device, like WhatsApp Web). Send

About

Connect a personal/Business WhatsApp account via QR pairing (multi-device, like WhatsApp Web). Send

Remote endpoints: streamable-http: https://api.mcp.ai/p_whatsapp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 0 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Open access · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-mcp-dir-whatsapp-mcp": {
      "url": "https://api.mcp.ai/p_whatsapp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

WhatsApp

WhatsApp para Claude, ChatGPT e agentes de IA

Conecte uma conta de WhatsApp pessoal/Business via pareamento por QR (multi-device, como o WhatsApp Web). Envie e leia mensagens, listas chats, contatos, grupos e faça busca full-text no histórico. Suporte opcional a proxy SOCKS5/HTTPS por conexão, recomendado para evitar bloqueios em IPs de datacenter (Cloudflare/AWS).

  • 📊 41 ferramentas
  • ✏️ Leitura e escrita
  • 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
  • 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes


Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors+Adicionar conector personalizado → cole Nome WhatsApp e URL https://api.mcp.ai/p_whatsapp.

Cursor

➕ Instalar WhatsApp no Cursor

VS Code (Copilot Chat)

➕ Instalar WhatsApp no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_whatsapp

Detalhes por cliente: INSTALL.md.


Exemplos de uso

Liste meus últimos 20 chats no WhatsApp
Busque no histórico todas as mensagens que mencionem 'reunião'
Envie 'Cheguei!' para +5511999999999

41 ferramentas disponíveis

ToolDescrição
whatsapp_list_accountsList WhatsApp accounts paired to this install — wa_jid, phone, label, proxy on/off, status.
whatsapp_syncRefresh this account's local data from WhatsApp — pulls recent messages and refreshes the groups/contacts lists into the local store.
whatsapp_send_textSend a WhatsApp message (text or media).
whatsapp_send_mediaSend a WhatsApp message (text or media).
whatsapp_chatsList WhatsApp chats (individual + group).
whatsapp_messagesList messages in a chat from LOCAL history.
whatsapp_messages_writeMark messages as read in a chat.
whatsapp_contacts_listRead WhatsApp contacts. Actions: - list: search across contacts (query optional — substring on name/phone). Default limit 50. - get: full contact info by JID. [Flattened action: list]
whatsapp_contacts_getRead WhatsApp contacts. Actions: - list: search across contacts (query optional — substring on name/phone). Default limit 50. - get: full contact info by JID. [Flattened action: get]
whatsapp_groupsList WhatsApp groups the account belongs to — subject, jid, participants count, owner.
whatsapp_group_membersList the members of a WhatsApp group (live).
whatsapp_group_participants_addManage participants of a WhatsApp group (the connected account must be a group admin).
whatsapp_group_participants_removeManage participants of a WhatsApp group (the connected account must be a group admin).
whatsapp_group_participants_promoteManage participants of a WhatsApp group (the connected account must be a group admin).
whatsapp_group_participants_demoteManage participants of a WhatsApp group (the connected account must be a group admin).
whatsapp_reactReact to a message with an emoji (or remove your reaction by passing an empty emoji).
whatsapp_poll_createSend a poll or vote on one. Actions: - create: { to, name, options[] (2–12), selectable_count? } - vote: { chat_jid, message_id, options[] (the option texts to select) } [Flattened action: create] Bulk support: accept…
whatsapp_poll_voteSend a poll or vote on one. Actions: - create: { to, name, options[] (2–12), selectable_count? } - vote: { chat_jid, message_id, options[] (the option texts to select) } [Flattened action: vote] Bulk support: accepts…
whatsapp_message_deleteManage a message you can act on.
whatsapp_message_forwardManage a message you can act on.
whatsapp_message_editManage a message you can act on.
whatsapp_chat_metadataGet metadata for a single chat (subject/name, archived/pinned/muted state, unread count, timestamps).
whatsapp_chat_archiveChange a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: archive]
whatsapp_chat_unarchiveChange a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: unarchive]
whatsapp_chat_pinChange a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: pin]
whatsapp_chat_unpinChange a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: unpin]
whatsapp_chat_muteChange a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: mute]
whatsapp_chat_unmuteChange a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: unmute]
whatsapp_group_manage_createGroup lifecycle/admin (the connected account must be a group admin for most actions).
whatsapp_group_manage_leaveGroup lifecycle/admin (the connected account must be a group admin for most actions).
whatsapp_group_manage_updateGroup lifecycle/admin (the connected account must be a group admin for most actions).
whatsapp_group_manage_invite_linkGroup lifecycle/admin (the connected account must be a group admin for most actions).
whatsapp_group_manage_joinGroup lifecycle/admin (the connected account must be a group admin for most actions).
whatsapp_group_manage_requestsGroup lifecycle/admin (the connected account must be a group admin for most actions).
whatsapp_searchFull-text search across all stored messages (SQLite FTS5).
whatsapp_history_coverageShow how far back the LOCAL message archive reaches per chat (oldest_ts, newest_ts, message_count, status).
whatsapp_history_backfillRequest OLDER messages for a chat from your phone (on-demand history sync), extending what whatsapp_messages can read.
whatsapp_webhook_getShow this WhatsApp install's outbound webhook: the current URL, the subscribed events (empty = all), include_result, and the catalog of subscribable events (available_events — e.g.
whatsapp_webhook_setSet (or remove) this WhatsApp install's outbound webhook.
whatsapp_config_getShow this install's editable-after-connect settings per connected number — currently the proxy (proxy_url): whether it's set and a masked preview (the raw value is never returned).
whatsapp_config_setChange an editable-after-connect setting on a connected number WITHOUT re-pairing.

Detalhe de cada tool: docs/ferramentas.md


Preços

Cobrança por conexão ativa. Veja docs/precos.md.


Privacidade & LGPD

  • Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
  • Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_whatsapp.


Suporte


Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_whatsapp é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.

Reviews

No reviews yet

Be the first to review this server!