WAHA
Get Started

WhatsApp AI Agents with MCP

WAHA turns your self-hosted WhatsApp into an MCP server so AI agents — Claude, Goose, OpenClaw, and others — can read chats, send messages, manage contacts, and more through your own infrastructure.

Set granular permission scopes to control exactly what each agent is allowed to do.

WAHA logo
MCP logo

What You Can Do with WhatsApp MCP

U
You

Summarize customer messages for the last 7 days in chat 120363045@g.us

✦
Agent
W
Used chats-get-messages via MCP · 247 messages

Here's a summary of customer activity over the last 7 days:

Top topics

  • Shipping delays — 23 customers asking about late orders; most affected by carrier delays in the northeast.
  • Refund requests — 8 open cases, 3 of which are past the 5-day SLA.
  • Product questions — 41 inquiries about sizing and availability; top item: the navy jacket.

Action items

  • Follow up with 3 customers whose refunds are overdue
  • Post a shipping delay notice to reduce repeat inquiries
  • Restock the navy jacket — frequently asked about, currently out of stock
U
You

Download files for the last 7 days in chat 120363045@g.us

✦
Agent
W
Used chats-get-messages via MCP · downloadMedia=true · 28 files
W
Used curl via MCP · ×28 downloads

Downloaded 28 files from the last 7 days:

  • 14 images — .jpg, .png
  • 9 documents — .pdf, .docx
  • 5 videos — .mp4
U
You

Delete spam messages for the last 7 days in chat 120363045@g.us

✦
Agent
W
Used chats-get-messages via MCP · 187 messages scanned
W
Used chats-delete-message via MCP · ×14 calls

Deleted 14 spam messages matching these patterns:

  • Repeated promotional links from unknown numbers
  • "Forward this to 10 people" chain messages
  • Identical messages sent more than 3 times in a row

187 messages were scanned — the remaining 173 were left untouched.

Control Your AI Agent

Set granular permission scopes per API key — allow or restrict exactly what each agent can read, send, or delete.
WAHA MCP agent permissions screenshot

How To Use?

Start WAHA
1. Start WAHA
Run one command in the terminal on your own server
Pair Number
2. Pair Number
Scan QR code to connect your WhatsApp number
Connect Agent
3. Connect Your Agent
Add the MCP server URL to your AI tool and start automating
WAHA dashboard Scan QR on phone Swagger API reference

How To Start?

Follow ⚡ Quick Start to run WAHA, then check out
🤖 MCP to connect your AI agent!

Why WAHA?

Free

It's free!

WAHA Core version is always free, with no limits on messages or time!
WAHA Plus version has no license expiration!

Servers

Self-hosted solution

No strings attached to suspicious SaaS WhatsApp API solutions. Install it on your own server!

API

HTTP / REST API

Use your favorite language - Python, JavaScript, PHP, C#, Clojure, or PowerShell.
PowerShell, really? Are you insane?! Choose another language, dude.

Document

Scalable

You can easily run 1 session to automate your WhatsApp and scale it to 500 sessions to provide a SaaS solution!

Easy

Easy & Simple

You can run the API in a click!* Documentation has many examples and how-to guides.
*It's actually "a command", not a click.

Checked

No blocking

Under the hood it runs a real instance of WhatsApp Web to avoid getting blocked.
WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.