---
bezeichner: "io.github.singleflo/evolution-api-mcp"
art: "mcp_server"
slug: "io-github-singleflo-evolution-api-mcp"
paketkoordinate: "pypi:evolution-api-mcp"
status: "aktiv"
homepage: "https://github.com/singleflo/evolution-api-mcp"
erhebungsstand: "2026-10-10T01:17:01.464Z"
namensraum: "io.github.singleflo"
registerseite: "https://tracevero.com/mcp/io-github-singleflo-evolution-api-mcp"
abgerufen_am: "2026-10-10"
zugangsdaten_erforderlich: true
ausfuehrungsort: "lokal"
dateisystem_pfadargument: false
quelloffen_einsehbar: true
einsatzgebiet: "kurznachricht"
roh_beschreibung: "Operate one Evolution API (WhatsApp) instance: chats, history, sending, groups, settings."
version: "1.0.0"
roh_umgebungsvariablen: "EVOLUTION_API_URL, EVOLUTION_INSTANCE_TOKEN, EVOLUTION_MCP_TOOLSETS, EVOLUTION_MCP_ALLOW, EVOLUTION_MCP_DENY, EVOLUTION_MCP_ALLOW_IRREVERSIBLE, EVOLUTION_MCP_DEFAULT_DELAY_MS, EVOLUTION_MCP_MAX_WRITES_PER_MINUTE, EVOLUTION_MCP_FILE_ROOTS, EVOLUTION_MCP_DOWNLOAD_DIR, EVOLUTION_MCP_TIMEZONE"
roh_geheime_pflichtvariablen: "EVOLUTION_INSTANCE_TOKEN"
roh_transportarten: "stdio, streamable-http"
roh_pfadargumente: ""
roh_repository_url: "https://github.com/singleflo/evolution-api-mcp"
roh_paketquellen: "pypi"
roh_geheime_pflichtkopfzeilen: ""
roh_pfad_umgebungsvariablen: ""
roh_remote_adressen: "https://evolution-mcp.singleflo.com/mcp"
roh_remote_hosts: "evolution-mcp.singleflo.com"
roh_statusmeldung: ""
roh_veroeffentlicht_am: "2026-10-07"
roh_aktualisiert_am: "2026-10-07"
roh_schemafassung: "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json"
roh_bereitstellungsform: "paket und remote"
roh_repository_quelle: "github"
roh_repository_unterordner: ""
roh_paketbezeichner: "evolution-api-mcp"
roh_paketversionen: "1.0.0"
roh_laufzeithinweise: ""
roh_umgebungsformate: "number, string"
roh_umgebungsbeschreibungen: "EVOLUTION_API_URL=URL of your Evolution API server (e.g. https://evolution.example.com). Evolution API 2.x is required. · EVOLUTION_INSTANCE_TOKEN=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. · EVOLUTION_MCP_ALLOW=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. · EVOLUTION_MCP_ALLOW_IRREVERSIBLE=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. · EVOLUTION_MCP_DEFAULT_DELAY_MS=Milliseconds of 'typing...' Evolution shows before each message is sent when a call gives no delay. Integer from 0 to 20000. Default: 1200. · EVOLUTION_MCP_DENY=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. · EVOLUTION_MCP_DOWNLOAD_DIR=Absolute folder where download_message_media saves received files and export_chat its exports/ folders. Default: ~/Downloads/evolution-api-mcp. · EVOLUTION_MCP_FILE_ROOTS=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. · EVOLUTION_MCP_MAX_WRITES_PER_MINUTE=Maximum number of tools that change data per minute on this server; 0 turns the limit off. Integer, 0 or more. Default: 30. · EVOLUTION_MCP_TIMEZONE=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. · EVOLUTION_MCP_TOOLSETS=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."
roh_symbolformate: ""
roh_verbindungswege: "{\"packages\":[{\"registryType\":\"pypi\",\"identifier\":\"evolution-api-mcp\",\"version\":\"1.0.0\",\"transport\":\"stdio\",\"environment\":[{\"name\":\"EVOLUTION_API_URL\",\"description\":\"URL of your Evolution API server (e.g. https://evolution.example.com). Evolution API 2.x is required.\",\"format\":\"string\",\"required\":true,\"secret\":false},{\"name\":\"EVOLUTION_INSTANCE_TOKEN\",\"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.\",\"format\":\"string\",\"required\":true,\"secret\":true},{\"name\":\"EVOLUTION_MCP_TOOLSETS\",\"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.\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"EVOLUTION_MCP_ALLOW\",\"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.\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"EVOLUTION_MCP_DENY\",\"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.\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"EVOLUTION_MCP_ALLOW_IRREVERSIBLE\",\"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.\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"EVOLUTION_MCP_DEFAULT_DELAY_MS\",\"description\":\"Milliseconds of 'typing...' Evolution shows before each message is sent when a call gives no delay. Integer from 0 to 20000. Default: 1200.\",\"format\":\"number\",\"required\":false,\"secret\":false},{\"name\":\"EVOLUTION_MCP_MAX_WRITES_PER_MINUTE\",\"description\":\"Maximum number of tools that change data per minute on this server; 0 turns the limit off. Integer, 0 or more. Default: 30.\",\"format\":\"number\",\"required\":false,\"secret\":false},{\"name\":\"EVOLUTION_MCP_FILE_ROOTS\",\"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.\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"EVOLUTION_MCP_DOWNLOAD_DIR\",\"description\":\"Absolute folder where download_message_media saves received files and export_chat its exports/ folders. Default: ~/Downloads/evolution-api-mcp.\",\"format\":\"string\",\"required\":false,\"secret\":false},{\"name\":\"EVOLUTION_MCP_TIMEZONE\",\"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.\",\"format\":\"string\",\"required\":false,\"secret\":false}],\"additional_arguments_declared\":false}],\"remotes\":[{\"url\":\"https://evolution-mcp.singleflo.com/mcp\",\"transport\":\"streamable-http\",\"headers\":[]}]}"
---

# io.github.singleflo/evolution-api-mcp

## Measured values

| Property | Value | Source | Collected on | Level of trust | Raw declaration |
| --- | --- | --- | --- | --- | --- |
| Required secrets declared | true | MCP-Register | 2026-10-08T01:17:01.893Z | abgeleitet | roh_geheime_pflichtvariablen: EVOLUTION_INSTANCE_TOKEN; roh_geheime_pflichtkopfzeilen: |
| Execution location | lokal | MCP-Register | 2026-10-08T01:17:01.893Z | abgeleitet | roh_transportarten: stdio, streamable-http |
| Path argument present | false | MCP-Register | 2026-10-08T01:17:01.893Z | abgeleitet | roh_pfadargumente: ; roh_pfad_umgebungsvariablen: |
| Repository URL listed | true | MCP-Register | 2026-10-08T01:17:01.893Z | abgeleitet | roh_repository_url: https://github.com/singleflo/evolution-api-mcp |
| Field of use, derived from the vendor description | kurznachricht | MCP-Register | 2026-10-08T01:17:01.893Z | abgeleitet | roh_beschreibung: Operate one Evolution API (WhatsApp) instance: chats, history, sending, groups, settings. |
| Description (raw) | Operate one Evolution API (WhatsApp) instance: chats, history, sending, groups, settings. | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Declared version | 1.0.0 | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Environment variables (raw) | EVOLUTION_API_URL, EVOLUTION_INSTANCE_TOKEN, EVOLUTION_MCP_TOOLSETS, EVOLUTION_MCP_ALLOW, EVOLUTION_MCP_DENY, EVOLUTION_MCP_ALLOW_IRREVERSIBLE, EVOLUTION_MCP_DEFAULT_DELAY_MS, EVOLUTION_MCP_MAX_WRITES_PER_MINUTE, EVOLUTION_MCP_FILE_ROOTS, EVOLUTION_MCP_DOWNLOAD_DIR, EVOLUTION_MCP_TIMEZONE | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Required secret variables (raw) | EVOLUTION_INSTANCE_TOKEN | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Transports (raw) | stdio, streamable-http | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Path arguments (raw) |  | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Repository (raw) | https://github.com/singleflo/evolution-api-mcp | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Package registries (raw) | pypi | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Required secret headers (raw) |  | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Path environment variables (raw) |  | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Remote URLs (raw) | https://evolution-mcp.singleflo.com/mcp | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Remote hosts (raw) | evolution-mcp.singleflo.com | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Registry status message (raw) |  | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| First listed in the registry (raw) | 2026-10-07 | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Last changed in the registry (raw) | 2026-10-07 | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Schema version of the raw record (raw) | https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Delivery form (raw) | paket und remote | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Repository platform (raw) | github | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Repository subfolder (raw) |  | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Package identifiers (raw) | evolution-api-mcp | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Package versions (raw) | 1.0.0 | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Runtime hints (raw) |  | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Environment variable formats (raw) | number, string | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Environment variable descriptions (raw) | EVOLUTION_API_URL=URL of your Evolution API server (e.g. https://evolution.example.com). Evolution API 2.x is required. · EVOLUTION_INSTANCE_TOKEN=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. · EVOLUTION_MCP_ALLOW=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. · EVOLUTION_MCP_ALLOW_IRREVERSIBLE=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. · EVOLUTION_MCP_DEFAULT_DELAY_MS=Milliseconds of 'typing...' Evolution shows before each message is sent when a call gives no delay. Integer from 0 to 20000. Default: 1200. · EVOLUTION_MCP_DENY=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. · EVOLUTION_MCP_DOWNLOAD_DIR=Absolute folder where download_message_media saves received files and export_chat its exports/ folders. Default: ~/Downloads/evolution-api-mcp. · EVOLUTION_MCP_FILE_ROOTS=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. · EVOLUTION_MCP_MAX_WRITES_PER_MINUTE=Maximum number of tools that change data per minute on this server; 0 turns the limit off. Integer, 0 or more. Default: 30. · EVOLUTION_MCP_TIMEZONE=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. · EVOLUTION_MCP_TOOLSETS=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. | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Icon formats (raw) |  | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |
| Connection paths (source structure) | {"packages":[{"registryType":"pypi","identifier":"evolution-api-mcp","version":"1.0.0","transport":"stdio","environment":[{"name":"EVOLUTION_API_URL","description":"URL of your Evolution API server (e.g. https://evolution.example.com). Evolution API 2.x is required.","format":"string","required":true,"secret":false},{"name":"EVOLUTION_INSTANCE_TOKEN","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.","format":"string","required":true,"secret":true},{"name":"EVOLUTION_MCP_TOOLSETS","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.","format":"string","required":false,"secret":false},{"name":"EVOLUTION_MCP_ALLOW","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.","format":"string","required":false,"secret":false},{"name":"EVOLUTION_MCP_DENY","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.","format":"string","required":false,"secret":false},{"name":"EVOLUTION_MCP_ALLOW_IRREVERSIBLE","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.","format":"string","required":false,"secret":false},{"name":"EVOLUTION_MCP_DEFAULT_DELAY_MS","description":"Milliseconds of 'typing...' Evolution shows before each message is sent when a call gives no delay. Integer from 0 to 20000. Default: 1200.","format":"number","required":false,"secret":false},{"name":"EVOLUTION_MCP_MAX_WRITES_PER_MINUTE","description":"Maximum number of tools that change data per minute on this server; 0 turns the limit off. Integer, 0 or more. Default: 30.","format":"number","required":false,"secret":false},{"name":"EVOLUTION_MCP_FILE_ROOTS","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.","format":"string","required":false,"secret":false},{"name":"EVOLUTION_MCP_DOWNLOAD_DIR","description":"Absolute folder where download_message_media saves received files and export_chat its exports/ folders. Default: ~/Downloads/evolution-api-mcp.","format":"string","required":false,"secret":false},{"name":"EVOLUTION_MCP_TIMEZONE","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.","format":"string","required":false,"secret":false}],"additional_arguments_declared":false}],"remotes":[{"url":"https://evolution-mcp.singleflo.com/mcp","transport":"streamable-http","headers":[]}]} | MCP-Register | 2026-10-08T01:17:01.893Z | selbstauskunft |  |

## Links

- Namespace: [[namensraum/io-github-singleflo|io.github.singleflo]]

---

- Registry page: <https://tracevero.com/mcp/io-github-singleflo-evolution-api-mcp>
- Retrieved on: 2026-10-10
