MCP Evolution API Server

Example Use Cases

• 1

  Send text and media messages (images, audio, video, documents, stickers, locations, contacts) through an Evolution API-backed WhatsApp instance.

• 2

  Manage WhatsApp instances and session state (check instance status, restart, logout, set presence) and automate chat-level actions (archive, mark read, delete).

• 3

  Integrate conversational workflows with external tools (Claude Desktop, n8n, Chatwoot, Typebot) and load resources like contact, chat and group lists programmatically.

Description

This project implements a Model Context Protocol (MCP) server that wraps an Evolution API v2 instance and exposes its capabilities (messaging, instance management, profile and group controls) to LLM-based agents. It supports STDIO and WebSocket transports, Docker deployment, and provides a set of callable tools and loadable resources for contacts, chats, groups and profile information. The server is intended to simplify integration of WhatsApp-like functionality into agent workflows and automation platforms such as Claude Desktop and n8n.