MCP server
Evolution Api MCP
Operate one Evolution API (WhatsApp) instance: chats, history, sending, groups, settings.
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 1.0.0
- Listing updated
- 4 days ago
About Evolution Api MCP
Evolution Api MCP is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Install
Run in a terminal
claude mcp add --transport http evolution-api-mcp https://evolution-mcp.singleflo.com/mcpAdd to Settings → Connectors → Add custom connector
https://evolution-mcp.singleflo.com/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"evolution-api-mcp": {
"url": "https://evolution-mcp.singleflo.com/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"evolution-api-mcp": {
"type": "http",
"url": "https://evolution-mcp.singleflo.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"evolution-api-mcp": {
"serverUrl": "https://evolution-mcp.singleflo.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"evolution-api-mcp": {
"type": "http",
"url": "https://evolution-mcp.singleflo.com/mcp"
}
}
}Configuration
EVOLUTION_API_URLURL of your Evolution API server (e.g. https://evolution.example.com). Evolution API 2.x is required.RequiredEVOLUTION_INSTANCE_TOKENThe 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.RequiredEVOLUTION_MCP_TOOLSETSToolsets 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.EVOLUTION_MCP_ALLOWTools 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.EVOLUTION_MCP_DENYTool 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.EVOLUTION_MCP_ALLOW_IRREVERSIBLETools 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.EVOLUTION_MCP_DEFAULT_DELAY_MSMilliseconds of 'typing...' Evolution shows before each message is sent when a call gives no delay. Integer from 0 to 20000. Default: 1200.EVOLUTION_MCP_MAX_WRITES_PER_MINUTEMaximum number of tools that change data per minute on this server; 0 turns the limit off. Integer, 0 or more. Default: 30.EVOLUTION_MCP_FILE_ROOTSFolders 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.EVOLUTION_MCP_DOWNLOAD_DIRAbsolute folder where download_message_media saves received files and export_chat its exports/ folders. Default: ~/Downloads/evolution-api-mcp.EVOLUTION_MCP_TIMEZONEIANA 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.
Pricing
Open source
Evolution Api MCP FAQ
Is Evolution Api MCP free?
Yes. Evolution Api MCP is open source, so you can use and self-host it for free.
How do I add Evolution Api MCP to Claude Code?
Run this command in your terminal: claude mcp add --transport http evolution-api-mcp https://evolution-mcp.singleflo.com/mcp