Claude MarketplacesSubmit

Evolution WhatsApp

ewertonslv/evolution-whatsapp-mcp

Send and read WhatsApp messages, send media and manage instances via the Evolution API.

tools: 9
auth: Secret needed
transport: STDIO
env vars: 7
last updated: Nov 9, 2026

Tools

9 tools

Public tool metadata for what this MCP can expose to an agent.

send_textSend a text message to a phone number

Send a text message to a phone number

No parameter schema in public metadata yet.

send_mediaSend an image / video / document / audio (URL or base64)

Send an image / video / document / audio (URL or base64)

No parameter schema in public metadata yet.

find_chatsList the conversations on the instance (`limit`, default 50, max 200)

List the conversations on the instance (`limit`, default 50, max 200)

No parameter schema in public metadata yet.

find_messagesRead a chat's message history (by phone or JID), with `limit` (default 50, max 200) and `page`

Read a chat's message history (by phone or JID), with `limit` (default 50, max 200) and `page`

No parameter schema in public metadata yet.

create_instanceCreate a new instance (a WhatsApp connection slot)

Create a new instance (a WhatsApp connection slot)

No parameter schema in public metadata yet.

get_qrcodeGet the QR code (base64) to link a WhatsApp number

Get the QR code (base64) to link a WhatsApp number

No parameter schema in public metadata yet.

connection_statusCheck whether the instance is connected

Check whether the instance is connected

No parameter schema in public metadata yet.

disconnect_instanceLog the WhatsApp number out of the instance

Log the WhatsApp number out of the instance

No parameter schema in public metadata yet.

configure_webhookPoint the instance webhook to a public URL

Point the instance webhook to a public URL

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

EVOLUTION_API_URL*

Base URL of your Evolution API server, e.g. http://localhost:8080. Use https outside localhost.

EVOLUTION_API_KEY*secret

Evolution API key, sent as the apikey header.

EVOLUTION_DEFAULT_INSTANCE

Default instance used when a tool call omits the instance argument.

EVOLUTION_TIMEOUT_MS

Per-request timeout in milliseconds (default 30000).

EVOLUTION_READ_ONLY

Set to true to hide every tool that sends or changes state (send_text, send_media, create_instance, disconnect_instance, configure_webhook).

EVOLUTION_CONFIRM_WRITESdefault: false

Set to true to require a human confirmation (elicitation dialog) before send_text, send_media, create_instance, disconnect_instance or configure_webhook run. Clients that can show no dialog are refused. Default false; an unrecognised value counts as true and prints a warning.

EVOLUTION_ALLOWED_NUMBERS

Comma-separated phone numbers that send_text and send_media may reach. Empty means no restriction.

Readme

evolution-whatsapp-mcp

An MCP server that lets Claude (and any MCP client) use WhatsApp. It sends and reads messages, sends media, and manages connections through the Evolution API. Add it to Claude Desktop/Code and your agent can connect a WhatsApp number and talk to people.

The client code comes from the WhatsApp integration of a multi-tenant clinic SaaS. All nine tools were last checked against a real Evolution API 2.3.7 server in October 2026.

Architecture & where it runs

Claude (Desktop/Code)        evolution-whatsapp-mcp          Evolution API        WhatsApp
     [MCP client]   ──stdio──►   (this package)    ──HTTP──►   (gateway)  ──────►  (phone)

View the full README on GitHub

Details

Repository: github.com/ewertonslv/evolution-whatsapp-mcp
Website: github.com/Ewertonslv/evolution-whatsapp-mcp#readme
Categories: Communication & Messaging, Media & Entertainment
Package: evolution-whatsapp-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Communication & Messaging MCP servers

1

Email Deliverability Audit APIbr0ski777/email-deliverability-x402Audit email domain deliverability: SPF, DKIM, DMARC, MX. Score 0-100. x402.0stars

2

Email Finder APIbr0ski777/email-finder-x402Find email addresses from name and company domain. x402 paid.0stars

3

Email Verification APIbr0ski777/email-verification-x402Verify emails: syntax, MX records, disposable detection, quality score 0-100. x402 USDC.0stars

4

Email Validatorlazymac2x/email-validator-apiCloudflare Workers MCP server: email-validator0stars

5

Could Have Been Emailpipeworx-io/mcp-could-have-been-emailcould-have-been-email MCP — wraps StupidAPIs (keyless — no credential needed)0stars

6

Outlook Contactspipeworx-io/mcp-outlook-contactsOutlook Contacts (Microsoft 365) MCP Pack0stars