Back to Browse

Wa2agent Skills MCP Server

Developer ToolsLow Risk9.9MCP RegistryRemote
Free

Server data from the Official MCP Registry

Read-only WhatsApp MCP: your AI agent reads the WhatsApp chats you choose. Hosted, no laptop needed.

About

Read-only WhatsApp MCP: your AI agent reads the WhatsApp chats you choose. Hosted, no laptop needed.

Remote endpoints: streamable-http: https://vault-{vault_id}.wa2agent.link/mcp

Security Report

9.9
Low Risk9.9Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

Endpoint verified · Open access · 1 issue found

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

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

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-rosroyros-wa2agent": {
      "url": "https://vault-{vault_id}.wa2agent.link/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

wa2agent: read-only WhatsApp MCP for Claude, Codex and other AI agents

wa2agent gives your AI agent read-only access to the WhatsApp chats you choose. It is a hosted WhatsApp MCP server: your agent connects over MCP (or reads new messages by email), and you do not run anything on your own computer.

This repo holds the agent skill that sets it up.

How do I let Claude (or another agent) read my WhatsApp?

  1. Create a vault at https://wa2agent.link and link WhatsApp from your phone, like adding WhatsApp Web.
  2. Choose which chats to share: single groups and DMs, all groups, all DMs, or everything.
  3. Connect your agent: add your vault's MCP address to Claude, Claude Code, Codex or any MCP client, or turn on email delivery to an inbox your agent already reads.

Your agent can then turn school, family and work groups into events, tasks, follow-ups and a daily brief.

How is this different from lharries/whatsapp-mcp and other free servers?

Self-hosted servers such as lharries/whatsapp-mcp are a good choice if you want full control and can keep a computer running, update the bridge and repair it when it breaks. wa2agent runs the connection for you, so your agent can read shared chats while your laptop is closed. It is also read-only by design: your agent cannot send WhatsApp messages through it.

Is it safe?

  • Read-only. Your agent cannot send messages through wa2agent.
  • You choose the chats. Change or revoke them anytime.
  • Encrypted storage. Stored messages are encrypted with a key only your agent holds, so wa2agent can't read them. New messages pass through the service before they are encrypted, and the service handles chat names and message times so it can deliver them.
  • Short retention. Selected text messages are kept for 30 days. Media files are not downloaded.
  • Prompt injection. Anyone in a shared chat can write text your agent will read. The skill tells your agent to treat messages as source material, never as instructions, and read-only access means a tricked agent still cannot message your contacts.
  • WhatsApp account. wa2agent connects as a linked device, the same way WhatsApp Web does. It is not an official WhatsApp product, and WhatsApp decides what it allows on linked devices.

Details: privacy and storage.

Other ways to connect WhatsApp to AI

Comparing options? Awesome WhatsApp MCP lists self-hosted servers, hosted services, the Business API and the free export route, with their risks. It also has a free skill that reads WhatsApp chat exports, no account needed.

Install the skill

With the skills CLI:

npx skills add rosroyros/wa2agent-skills

Or copy skills/wa2agent-whatsapp/ into your agent's skills folder, for example .claude/skills/ (Claude Code) or .agents/skills/ (Codex).

Then ask your agent: "Connect my WhatsApp with wa2agent so you can read my school and family groups."

Tested with fresh Claude Code and Codex agents: set up a vault, then read a message and an export email in new sessions.

Agent guides

About

wa2agent is invite-only for now; join the waitlist at https://wa2agent.link/login. Questions: info@wa2agent.link.

Built and operated by Roy Rosenfeld. Built on open-source WhatsApp connection tools, including wacli and whatsmeow.

Reviews

No reviews yet

Be the first to review this server!