Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

wa2agent

by rosroyrosversion 1.1.1i★ –iRuns in the cloud
Registry nameio.github.rosroyros/wa2agent

Install

Overview

Description from the maker (original English)

Read-only WhatsApp MCP for your AI agent: it reads the chats you choose. Try the public demo.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs in the cloud
  • Transport: Streamable HTTP
  • Category: Chat & email
  • You need to fill in: Authorization

Install

Pick the AI app you use, then copy the settings.

Before you install

  • Basic checks: 1 of 1 passed
  • Runs on the maker’s server: what you ask it goes through their server.
  • You fill in yourself: Authorization

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Run this in your terminal

claude mcp add --transport http wa2agent 'https://vault-{vault_id}.wa2agent.link/mcp' --header 'Authorization: your-value'

Fill in the empty values before running it.

The address contains {…} parts that only you know (such as your account), so copy it and fill them in.

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "wa2agent": {
      "url": "https://vault-{vault_id}.wa2agent.link/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

The address contains {…} parts that only you know (such as your account), so copy it and fill them in.

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "wa2agent": {
      "type": "http",
      "url": "https://vault-{vault_id}.wa2agent.link/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

  • Authorization secret required HTTP header
    Bearer

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account rosroyros, which owns the repo

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • – Not applicable

    Endpoint responds

    The address needs your own account values, so we cannot check it for you

  • – Not applicable

    Sign-in with OAuth

    The address needs your own account values, so we cannot check it for you

  • … Not checked yet

    No hidden instructions in tool descriptions

    Not checked yet; we read the tool list when we check the endpoint

Compared with others in Chat & emaili

  • More stars than 0% of the other 1782 servers in this category
  • Published to the registry more recently than 70% of the other 1782 servers in this category
  • Basic checks equal to or better than 100% of the other 1782 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is wa2agent safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: Authorization

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.1.1) reached the registry 12 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Vexa, emailmd, MCP WhatsApp Cloud

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Vexa

by Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

Runs in the cloud★ 2,949Apache-2.0Updated 2 months ago
Install

emailmd

by anypost

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

Computer or cloud★ 1,385MITUpdated 31 days ago
Install

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

Runs on your computer★ 277MITUpdated 5 months ago
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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.

Try it without an invite

A public demo with fictional chats: connect any MCP client to https://demo.wa2agent.link/mcp with the public key on wa2agent.link/demo. Read-only, synthetic data only.

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.

Ask PopNx