Koskamo

Evolution API MCP

An MCP server that operates one Evolution API v2 instance, which is one WhatsApp number: it reads chats and message history, sends messages and media, manages groups, contacts, labels, templates and profile, and configures the instance, its webhooks and its chatbots.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Evolution API MCP logo, by Persevida SLCommunity listingLocal stdioSource reviewed; not executedPublished by Persevida SL
Vendor documentation

What you can do with it

  • Read chats and message history
  • Send messages and media
  • Manage groups, contacts, labels, templates and profile
  • Configure the instance, its webhooks and its chatbots

Source and maintenance

Community listingRegistry 1.0.0
mcp-registry: io.github.singleflo/evolution-api-mcp@1.0.0Source repository
Maintenance checked

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

evolution-api-mcp 1.0.0

pypi
evolution-api-mcp package definition
{
  "version": "1.0.0",
  "transport": "stdio",
  "identifier": "evolution-api-mcp",
  "registryType": "pypi",
  "environmentVariables": [
    {
      "name": "EVOLUTION_API_URL",
      "format": "string",
      "isRequired": true,
      "description": "URL of your Evolution API server (e.g. https://evolution.example.com). Evolution API 2.x is required."
    },
    {
      "name": "EVOLUTION_INSTANCE_TOKEN",
      "format": "string",
      "isRequired": true,
      "description": "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."
    },
    {
      "name": "EVOLUTION_MCP_TOOLSETS",
      "format": "string",
      "description": "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."
    },
    {
      "name": "EVOLUTION_MCP_ALLOW",
      "format": "string",
      "description": "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."
    },
    {
      "name": "EVOLUTION_MCP_DENY",
      "format": "string",
      "description": "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."
    },
    {
      "name": "EVOLUTION_MCP_ALLOW_IRREVERSIBLE",
      "format": "string",
      "description": "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."
    },
    {
      "name": "EVOLUTION_MCP_DEFAULT_DELAY_MS",
      "format": "number",
      "description": "Milliseconds of 'typing...' Evolution shows before each message is sent when a call gives no delay. Integer from 0 to 20000. Default: 1200."
    },
    {
      "name": "EVOLUTION_MCP_MAX_WRITES_PER_MINUTE",
      "format": "number",
      "description": "Maximum number of tools that change data per minute on this server; 0 turns the limit off. Integer, 0 or more. Default: 30."
    },
    {
      "name": "EVOLUTION_MCP_FILE_ROOTS",
      "format": "string",
      "description": "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."
    },
    {
      "name": "EVOLUTION_MCP_DOWNLOAD_DIR",
      "format": "string",
      "description": "Absolute folder where download_message_media saves received files and export_chat its exports/ folders. Default: ~/Downloads/evolution-api-mcp."
    },
    {
      "name": "EVOLUTION_MCP_TIMEZONE",
      "format": "string",
      "description": "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."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.
Cursor configuration
{
  "mcpServers": {
    "evolution-api-mcp-mcp": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp==1.0.0"
      ],
      "env": {
        "EVOLUTION_API_URL": "<YOUR_EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<YOUR_EVOLUTION_INSTANCE_TOKEN>",
        "EVOLUTION_MCP_TOOLSETS": "<YOUR_EVOLUTION_MCP_TOOLSETS>",
        "EVOLUTION_MCP_ALLOW": "<YOUR_EVOLUTION_MCP_ALLOW>",
        "EVOLUTION_MCP_DENY": "<YOUR_EVOLUTION_MCP_DENY>",
        "EVOLUTION_MCP_ALLOW_IRREVERSIBLE": "<YOUR_EVOLUTION_MCP_ALLOW_IRREVERSIBLE>",
        "EVOLUTION_MCP_DEFAULT_DELAY_MS": "<YOUR_EVOLUTION_MCP_DEFAULT_DELAY_MS>",
        "EVOLUTION_MCP_MAX_WRITES_PER_MINUTE": "<YOUR_EVOLUTION_MCP_MAX_WRITES_PER_MINUTE>",
        "EVOLUTION_MCP_FILE_ROOTS": "<YOUR_EVOLUTION_MCP_FILE_ROOTS>",
        "EVOLUTION_MCP_DOWNLOAD_DIR": "<YOUR_EVOLUTION_MCP_DOWNLOAD_DIR>",
        "EVOLUTION_MCP_TIMEZONE": "<YOUR_EVOLUTION_MCP_TIMEZONE>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.
Cline configuration
{
  "mcpServers": {
    "evolution-api-mcp-mcp": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp==1.0.0"
      ],
      "env": {
        "EVOLUTION_API_URL": "<YOUR_EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<YOUR_EVOLUTION_INSTANCE_TOKEN>",
        "EVOLUTION_MCP_TOOLSETS": "<YOUR_EVOLUTION_MCP_TOOLSETS>",
        "EVOLUTION_MCP_ALLOW": "<YOUR_EVOLUTION_MCP_ALLOW>",
        "EVOLUTION_MCP_DENY": "<YOUR_EVOLUTION_MCP_DENY>",
        "EVOLUTION_MCP_ALLOW_IRREVERSIBLE": "<YOUR_EVOLUTION_MCP_ALLOW_IRREVERSIBLE>",
        "EVOLUTION_MCP_DEFAULT_DELAY_MS": "<YOUR_EVOLUTION_MCP_DEFAULT_DELAY_MS>",
        "EVOLUTION_MCP_MAX_WRITES_PER_MINUTE": "<YOUR_EVOLUTION_MCP_MAX_WRITES_PER_MINUTE>",
        "EVOLUTION_MCP_FILE_ROOTS": "<YOUR_EVOLUTION_MCP_FILE_ROOTS>",
        "EVOLUTION_MCP_DOWNLOAD_DIR": "<YOUR_EVOLUTION_MCP_DOWNLOAD_DIR>",
        "EVOLUTION_MCP_TIMEZONE": "<YOUR_EVOLUTION_MCP_TIMEZONE>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.
VS Code configuration
{
  "servers": {
    "evolution-api-mcp-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "evolution-api-mcp==1.0.0"
      ],
      "env": {
        "EVOLUTION_API_URL": "<YOUR_EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<YOUR_EVOLUTION_INSTANCE_TOKEN>",
        "EVOLUTION_MCP_TOOLSETS": "<YOUR_EVOLUTION_MCP_TOOLSETS>",
        "EVOLUTION_MCP_ALLOW": "<YOUR_EVOLUTION_MCP_ALLOW>",
        "EVOLUTION_MCP_DENY": "<YOUR_EVOLUTION_MCP_DENY>",
        "EVOLUTION_MCP_ALLOW_IRREVERSIBLE": "<YOUR_EVOLUTION_MCP_ALLOW_IRREVERSIBLE>",
        "EVOLUTION_MCP_DEFAULT_DELAY_MS": "<YOUR_EVOLUTION_MCP_DEFAULT_DELAY_MS>",
        "EVOLUTION_MCP_MAX_WRITES_PER_MINUTE": "<YOUR_EVOLUTION_MCP_MAX_WRITES_PER_MINUTE>",
        "EVOLUTION_MCP_FILE_ROOTS": "<YOUR_EVOLUTION_MCP_FILE_ROOTS>",
        "EVOLUTION_MCP_DOWNLOAD_DIR": "<YOUR_EVOLUTION_MCP_DOWNLOAD_DIR>",
        "EVOLUTION_MCP_TIMEZONE": "<YOUR_EVOLUTION_MCP_TIMEZONE>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.
Claude Desktop configuration
{
  "mcpServers": {
    "evolution-api-mcp-mcp": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp==1.0.0"
      ],
      "env": {
        "EVOLUTION_API_URL": "<YOUR_EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<YOUR_EVOLUTION_INSTANCE_TOKEN>",
        "EVOLUTION_MCP_TOOLSETS": "<YOUR_EVOLUTION_MCP_TOOLSETS>",
        "EVOLUTION_MCP_ALLOW": "<YOUR_EVOLUTION_MCP_ALLOW>",
        "EVOLUTION_MCP_DENY": "<YOUR_EVOLUTION_MCP_DENY>",
        "EVOLUTION_MCP_ALLOW_IRREVERSIBLE": "<YOUR_EVOLUTION_MCP_ALLOW_IRREVERSIBLE>",
        "EVOLUTION_MCP_DEFAULT_DELAY_MS": "<YOUR_EVOLUTION_MCP_DEFAULT_DELAY_MS>",
        "EVOLUTION_MCP_MAX_WRITES_PER_MINUTE": "<YOUR_EVOLUTION_MCP_MAX_WRITES_PER_MINUTE>",
        "EVOLUTION_MCP_FILE_ROOTS": "<YOUR_EVOLUTION_MCP_FILE_ROOTS>",
        "EVOLUTION_MCP_DOWNLOAD_DIR": "<YOUR_EVOLUTION_MCP_DOWNLOAD_DIR>",
        "EVOLUTION_MCP_TIMEZONE": "<YOUR_EVOLUTION_MCP_TIMEZONE>"
      }
    }
  }
}

Let your agent find its tools

Find servers like Evolution API MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 4,479