iflow-mcp_rhnvrm-listmonk-mcp

# Listmonk MCP Server An MCP (Model Context Protocol) server implementation for Listmonk, providing programmatic access to newsletter and mailing list management functionality. <image width=200px src="docs/logo.png" alt="Listmonk MCP Logo"> ## Project Status ✅ **Implementation Complete** - The core MCP server is fully implemented and functional. ## Goal Create an MCP server that enables LLMs and AI assistants to interact with Listmonk instances through the Model Context Protocol. This will allow for: - Subscriber management (add, remove, update subscribers) - Mailing list operations (create, manage lists) - Campaign management (create, send newsletters) - Analytics and reporting access - Template and content management ## Architecture This server will bridge the MCP protocol with Listmonk's REST API, providing a standardized interface for AI models to interact with Listmonk installations. ## Features - **Complete Listmonk API Coverage**: All major Listmonk operations supported - **18 MCP Tools**: Comprehensive subscriber, list, campaign, and template management - **MCP Resources**: Easy access to subscriber, list, campaign, and template data - **Async Operations**: Built with modern async/await patterns - **Type Safety**: Full Pydantic model validation - **Environment Configuration**: Easy setup with environment variables ## Installation ### Using uvx (Recommended) Install and run directly from PyPI without managing dependencies: ```bash # Run directly (installs if needed) uvx listmonk-mcp --help # Or install globally uvx install listmonk-mcp listmonk-mcp --help ``` ### Using pip ```bash pip install listmonk-mcp ``` ### Development Installation ```bash git clone https://github.com/rhnvrm/listmonk-mcp.git cd listmonk-mcp uv sync --extra dev ``` ## Development ### Code Quality Checks Run the same checks that are executed in the CI/CD pipeline: ```bash # Install development dependencies uv sync --extra dev # Run linting (same as CI) uv run ruf…