WireCat WhatsApp

Name: WireCat WhatsApp
Author: WireCatLabs

by WireCatLabsversion 0.38.0i★ 3iRuns on your computer

Registry namedev.wirecat/whatsapp-cli

How to install

What it does

Your WhatsApp account for agents: read, search and send messages. Sign in with the wa CLI first.

Connects Runs on your computer
Account or key No key needed
Category Chat & email

Install

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

Passed 3/3 checks · Runs on your computer

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Install Node.js
One time only; it works for every server that needs Node.js
Open the Node.js download page ↗
Done
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Done

Paste these settings and save the file

{
  "mcpServers": {
    "whatsapp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/whatsapp-cli",
        "mcp",
        "serve",
        "--profiles",
        "all"
      ]
    }
  }
}

Done

Quit Claude and open it again
Done
Try it
Use WireCat WhatsApp and tell me what you can do for me, then show me one thing
✓ If Claude says it is using WireCat WhatsApp or shows a WireCat WhatsApp tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect WireCat WhatsApp yet

WireCat WhatsApp runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect WireCat WhatsApp

Steps for Claude →Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Steps for Claude Code →Install Node.js on your computer first (one time)
Steps for Cursor →Install Node.js on your computer first (one time)
Steps for VS Code →Install Node.js on your computer first (one time)

B · Others in Chat & email that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Inbox Zero✓ ChatGPT
draw.io✓ ChatGPT
TradingMCP✓ ChatGPT

Works with Claude Code, with some setup first

Install Node.js on your computer first (one time)

Install Node.js
One time only; it works for every server that needs Node.js
Open the Node.js download page ↗
Done
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done

Paste this command and press Enter

claude mcp add --scope user whatsapp-cli -- npx -y @wirecat/whatsapp-cli mcp serve --profiles all

Done

Type /mcp in Claude Code
You should see WireCat WhatsApp listed as connected
Done
Try it
Use WireCat WhatsApp and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using WireCat WhatsApp or shows a WireCat WhatsApp tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Node.js on your computer first (one time)

Install Node.js
One time only; it works for every server that needs Node.js
Open the Node.js download page ↗
Done
Click this button to open Cursor
Open in Cursor
Cursor asks you to confirm; click Install
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use WireCat WhatsApp and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using WireCat WhatsApp or shows a WireCat WhatsApp tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Node.js on your computer first (one time)

Install Node.js
One time only; it works for every server that needs Node.js
Open the Node.js download page ↗
Done
Click this button to open VS Code
Open in VS Code
VS Code asks you to confirm; click Install
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use WireCat WhatsApp and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using WireCat WhatsApp or shows a WireCat WhatsApp tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use WireCat WhatsApp💬 Discussion →

For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user whatsapp-cli -- npx -y @wirecat/whatsapp-cli mcp serve --profiles all

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "whatsapp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/whatsapp-cli",
        "mcp",
        "serve",
        "--profiles",
        "all"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "whatsapp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/whatsapp-cli",
        "mcp",
        "serve",
        "--profiles",
        "all"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "whatsapp-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/whatsapp-cli",
        "mcp",
        "serve",
        "--profiles",
        "all"
      ]
    }
  }
}

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

At a glance

GitHub stars i: 3
Downloads per weeki: 3,410/wk
Verified domain: ✓ wirecat.dev
Licence i: Apache-2.0
Connection: Runs on your computer
Transport: stdio
Latest versioni: 0.38.0
Categoryi: Chat & email
Published to registryi: Nov 12, 2026
Code last changedi: Nov 12, 2026
Maker: WireCatLabs
Packages: npm: @wirecat/whatsapp-cli
Repo: WireCatLabs/whatsapp-cli
Website: wirecat.dev
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

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 12, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain wirecat.dev (the registry checks domain ownership)
✓ Pass
Still maintained
Code last changed today
✓ Pass
Has a licence
Uses Apache-2.0
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Chat & emaili

More stars than 92% of the other 1985 servers in this category
Published to the registry more recently than 97% of the other 1985 servers in this category
Basic checks equal to or better than 100% of the other 1985 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 WireCat WhatsApp safe?

It passed 3 of 3 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?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed today, and the latest version (0.38.0) reached the registry today.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Inbox Zero, draw.io, TradingMCP

Others in the same category

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

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

Inbox Zero

Search Gmail and Outlook, save drafts, manage email rules, and view email stats.

by elie222Widely used★ 13KUpdated 42 days ago

Runs in the cloud

Install

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

by jgraphWidely used★ 5.8KUpdated 2 days ago

Runs in the cloud✓ service owner · draw.io

Install

TradingMCP

Market analysis for AI assistants: screeners, multi-timeframe analysis, backtests, in-chat charts.

by atilaahmettanerWidely used★ 5.3KUpdated 21 days ago

Runs in the cloud

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.

wa — WhatsApp CLI for AI agents

Your personal WhatsApp in the terminal, searchable on your computer, and ready for Claude Code, Codex, Cursor or any agent — within limits you set.

Docs · Examples · WireCat

An example conversation (invented people, illustrative output):

You:    Use wa CLI. Who is waiting for my answer since yesterday?

Agent: (runs wa personal review 'date>1d' --unanswered: 3 chats) · Alice Example asked about Saturday's table, 18:40 yesterday · "Book club" — Bob Sample asked who brings the next book You: Tell Alice: yes, 8 pm. Agent: Draft to Alice Example: "Yes, 8 pm." Send it? You: Yes.

⚠️ `wa` is an unofficial client of your real WhatsApp account. WhatsApp's terms forbid unofficial clients, and

WhatsApp may ban an account that uses one. It also bans accounts that send in bulk or write to people who do not

know them. wa writes only when a command asks, sends at most 30 messages an hour by default, and holds every

write when WhatsApp says to slow down or restricts the account. Do not send in bulk, and do not write to strangers.

You use wa at your own risk. More: limits

Early. wa is new, and some of what it does has not yet been checked against real WhatsApp. The backlog lists the checks still to run.

More: compared with other tools · on wirecat.dev

Quick start

npm install -g @wirecat/whatsapp-cli

wa personal setup --agent claude # also codex, cursor, gemini, all or none wa personal server install # keep receiving in the background wa personal inbox # other people's unread messages; nothing is marked read

Allow about five minutes. wa personal setup links wa to your account as a device — you scan a QR code in WhatsApp → Settings → Linked devices — keeps the history your phone sends right after linking, checks your first chats and installs the agent skill.

It needs Node 22.16+ or 24+ on macOS, Linux or Windows. npm also installs the engine, the small program that speaks WhatsApp's protocol, as a separate package for your system.

More: installation guide · linking

What can you do?

Catch up. *"Use wa CLI. What came in since this morning, and who is waiting for my answer?"*

wa personal inbox

wa personal review 'date>1d' --unanswered

Find anything. *"Use wa CLI. When did we agree on the venue with Alice?"* — an answer with the date and the message itself.

wa personal search all "venue"            # messages and notes kept on this computer

Keep your promises. *"Use wa CLI. What did I promise, and what am I still waiting on?"*

wa personal review --new                  # what changed since the last review --new

wa personal tasks list state:open

Run your groups. *"Use wa CLI. Which questions in Hiking has nobody answered?"*

wa personal review chat:Hiking --unanswered

wa personal chats events Hiking 'time>=7d' # who joined, left, was added or removed

Answer, when you say so.

wa personal messages send "Book club" "Call at 3?" --reply-to 3EB0A1B2C3D4E5F6A7B8

wa personal messages edit "Book club" 3EB0A1B2C3D4E5F6A7B8 "Call at 4?" # your own, within 20 minutes wa personal reactions add "Book club" 3EB0A1B2C3D4E5F6A7B8 👍 wa personal messages delete "Book club" 3EB0A1B2C3D4E5F6A7B8 --for-everyone wa personal chats mark-read "Book club" # the other side sees it

More: recipes, with a schedule for each · using wa

Built for AI agents

Your agent. Your WhatsApp. Your rules.

Agents with a terminal (Claude Code, Codex, Gemini CLI) run wa commands themselves. The bundled skill tells them how: wa personal setup --agent … or wa skill install puts it in place, and wa skill show prints it before linking. An agent links by QR: it pastes the code into the chat as text for you to scan, and never asks for your phone number or a code.
Apps without a terminal (Claude Desktop, Cursor and other MCP clients) connect to wa personal mcp serve. It comes with ready prompts: /catch-up, /review, /reply, /find and more.

wa personal mcp add claude-code   # or: wa personal mcp add codex

wa personal mcp config # the entry for Claude Desktop, Cursor and others

The profile can send by default, so mcp add stops first. Check the profile's permissions, then run it again with --allow-writes.

More: the MCP server · from the browser

Why wa?

Your own account, as a linked device. wa links the way WhatsApp Web does. It sees your chats, groups and contacts, and speaks as you, not as a business account or a bot.
A business number too, when you have one. wa bot speaks for a WhatsApp Business number on Meta's Cloud API: send, templates, and messages received by webhook through your tunnel (bot).
Local-first search. Everything received is kept on your computer. Every read and search answers from there and never connects.
Made for agents. One operation per call, the same JSON shape every time with --json, a fixed exit code for each kind of failure, an MCP server and a skill.
Safe by default. Reading marks nothing read and sends no "online" or "typing". A profile decides which actions an agent may take, which chats it may send to, and how many messages an hour (30 by default). When a send's outcome is unknown, wa says so and never repeats it by itself.

Your account

wa works in your name, as one more linked device of your WhatsApp account.

wa personal chats list --limit 5

wa personal messages list "Book club" --limit 20 wa personal messages send "Book club" "The minutes" --file minutes.pdf wa personal polls create "Book club" "Which day?" Monday Tuesday wa personal messages download "Book club" 3EB0A1B2C3D4E5F6A7B8 --output-dir ~/Downloads wa personal messages transcribe "Book club" 3EB0A1B2C3D4E5F6A7B8 --local # a voice note as text

The message id 3EB0A1B2C3D4E5F6A7B8 is made up; take a real one from messages list -v.

Read. Chats and messages from the local store, one message with its neighbours, other people's unread messages (wa personal inbox), everything since the last review (wa personal review), new messages as they arrive (wa personal watch), older messages of one chat asked of your phone (wa personal messages sync), and the posts of the channels you follow (wa personal chats join with a channel link, then messages sync).
Write. Markdown, replies, one file, photo, video or voice note per message, a photo and a video as one album, edits of your own messages within 20 minutes, forwards, reactions, polls and votes, pins (each one tells the members), deleting for you or for everyone, and marking a chat read.
Your chat list. Mute, archive, pin or mark a chat unread, star a message, and delete or clear a chat on your own devices; nobody in the chat is told.
Voice on your computer. WhatsApp has no speech recognition of its own, so wa runs a speech model on this machine, downloaded only when you ask.
People. A person's profile, blocking, whether a number has WhatsApp, the phone's address book into the store, and your own names and notes for people.
Your account. Your own name, about line and profile photo (wa personal account update).
Privacy. Who sees your last seen, online, profile photo and about line, whether you send read receipts, who may add you to groups and whose calls ring (wa personal account privacy).

More files in one message than a photo and a video are not built yet: not in wa yet.

More: using wa · privacy · one person

Log in and profiles

wa links to your account as a device, the way WhatsApp Web does. There is no password and no app to register: you link once, from the phone, and the device keys go to one file only your user can read.

wa personal session start               # a QR code: WhatsApp → Settings → Linked devices → Link a device

wa personal session start phone # or your number, then a pairing code you type on the phone wa personal account show # who this profile is linked as wa account list # every profile here, and who each is linked as wa personal session end # unlink, and delete the device keys here

Several accounts are several profiles, and the profile is the first word, not an option:

wa personal chats list     # profile "personal"

wa work chats list # profile "work" export WA_PROFILE=work # or for the whole shell session

wa never picks a profile for you, not even the only one: a command that uses an account and has no profile named stops and lists the profiles on this computer. Name one or set WA_PROFILE. Each profile is a linked device of its own, with its own one connection.

More: linking, devices and profiles · profiles

The local store and search

Everything wa receives is kept in a local store on your computer, shared with tg and max. Search runs over it; nothing leaves your computer.

wa personal search messages 'contract chat:"Project Alpha"'

wa personal store status # how much of each chat is kept wa personal store export "Project Alpha" --format markdown --output alpha.md wa personal messages evidence "Project Alpha" --json # bounded evidence

Only the beginning is shown; read the rest in the repo

WireCat WhatsApp

What it does

Install

Install Node.js

Open the Claude desktop app’s settings file

Paste these settings and save the file

Quit Claude and open it again

Try it

What you can do instead

Install Node.js

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Install Node.js

Click this button to open Cursor

Open the AI chat in Cursor in Agent mode

Try it

Install Node.js

Click this button to open VS Code

Open the AI chat in VS Code in Agent mode

Try it

Installed on your computer

At a glance

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Discussion

User reviews

Compared with others in Chat & emaili

Common questions

Others in the same category

Inbox Zero

draw.io

TradingMCP

README from the maker

wa — WhatsApp CLI for AI agents

Quick start

What can you do?

Built for AI agents

Why wa?

Your account

Log in and profiles

The local store and search