Back to Browse

Evolution Api MCP Server

Developer ToolsLow Risk9.9MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

Operate one Evolution API (WhatsApp) instance: chats, history, sending, groups, settings.

About

Operate one Evolution API (WhatsApp) instance: chats, history, sending, groups, settings.

Remote endpoints: streamable-http: https://evolution-mcp.singleflo.com/mcp

Security Report

9.9
Low Risk9.9Low Risk

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

Endpoint verified · Open access · 2 issues found

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

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

URL of your Evolution API server (e.g. https://evolution.example.com). Evolution API 2.x is required.Optional

Environment variable: EVOLUTION_API_URL

The token of this one instance (Evolution Manager: open the instance and copy its token). The server's global AUTHENTICATION_API_KEY is refused. The instance name and integration are discovered from the token.Required

Environment variable: EVOLUTION_INSTANCE_TOKEN

Toolsets to enable: a comma list of instance, messaging, chats, contacts, groups, labels, profile, status, catalog, templates, settings, events, integrations, or the presets `core` and `all`. Default: `core` (messaging, chats, contacts). The --toolsets option overrides it.Optional

Environment variable: EVOLUTION_MCP_TOOLSETS

Tools that change data the agent may call. `*` (default) allows every tool not denied; `none` makes the server read-only; or a comma list of tool names. Reads are never gated by this list.Optional

Environment variable: EVOLUTION_MCP_ALLOW

Tool names the agent may never call. A value set here REPLACES the default list, which is post_status, remove_group_participants, set_webhook, set_event_channel, set_proxy, set_chatwoot_config.Optional

Environment variable: EVOLUTION_MCP_DENY

Tools that cannot be undone (logout_instance, delete_message_for_everyone, leave_group, delete_template, delete_chatbot, delete_openai_credential) run only when this is `yes` (also `true` or `1`). Default: no.Optional

Environment variable: EVOLUTION_MCP_ALLOW_IRREVERSIBLE

Milliseconds of 'typing...' Evolution shows before each message is sent when a call gives no delay. Integer from 0 to 20000. Default: 1200.Optional

Environment variable: EVOLUTION_MCP_DEFAULT_DELAY_MS

Maximum number of tools that change data per minute on this server; 0 turns the limit off. Integer, 0 or more. Default: 30.Optional

Environment variable: EVOLUTION_MCP_MAX_WRITES_PER_MINUTE

Folders send_local_files may read: absolute paths of existing directories separated by the operating system's path separator (':' on macOS and Linux, ';' on Windows). Default: Desktop, Documents, Downloads, Pictures, Movies and Music in the home folder (those that exist) plus the download folder.Optional

Environment variable: EVOLUTION_MCP_FILE_ROOTS

Absolute folder where download_message_media saves received files and export_chat its exports/ folders. Default: ~/Downloads/evolution-api-mcp.Optional

Environment variable: EVOLUTION_MCP_DOWNLOAD_DIR

IANA time zone for the times tools show and for times given without a zone, e.g. Europe/Rome. Default: the computer's zone (TZ, then /etc/localtime), else UTC.Optional

Environment variable: EVOLUTION_MCP_TIMEZONE

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Reviews

No reviews yet

Be the first to review this server!