Listmonk MCP Server

Listmonk MCP Server

Full API coverage of Listmonk email marketing FOSS.

17
Stars
3
Forks
1
Releases

Overview

An MCP server implementation for Listmonk that provides a standardized Model Context Protocol interface to interact with Listmonk installations through their REST API. The core server exposes the full Listmonk API surface to AI models, supporting subscriber management, list operations, campaign creation and sending, analytics access, and template/content handling. It is designed to bridge MCP with Listmonk’s REST endpoints, delivering a consistent, async-ready, type-safe interface for model-driven workflows. Key claims include complete API coverage, 18 MCP tools for common tasks, and easy access to subscriber, list, campaign, and template data. The project emphasizes environment-driven configuration via LISTMONK_MCP_URL, LISTMONK_MCP_USERNAME, and LISTMONK_MCP_PASSWORD, with token-based authentication using Authorization: token username:api_token. It includes development and testing guidance, Docker-based local Listmonk setup, and run instructions via uv or the CLI entry point. The server is fully implemented and ready for experimentation with local Listmonk deployments.

Details

Owner
rhnvrm
Language
Python
License
MIT License
Updated
2025-12-07

Features

Complete Listmonk API Coverage

All major Listmonk operations are supported by the MCP server.

18 MCP Tools

Comprehensive subscriber, list, campaign, and template management tools.

MCP Resources

Easy access to subscriber, list, campaign, and template data via MCP.

Async Operations

Built with modern async/await patterns for scalable interactions.

Type Safety

Full Pydantic model validation ensures robust data contracts.

Environment Configuration

Easy setup with environment variables for runtime configuration.

Audience

LLMs / AI developersInteract with Listmonk via MCP to manage subscribers, lists, campaigns, templates, and analytics.
MCP integrators / developersBridge AI assistants with Listmonk through a standardized MCP interface for AI-driven workflows.

Tags

ListmonkMCPModel Context Protocolemail marketingnewslettersubscriber managementcampaign managementtemplate managementasynctype safetyPydanticREST API bridgeenvironment configurationtoken authenticationLLMsAI assistants