n8n-nodes-listmonk-ai

This is an enhanced n8n community node that lets you use Listmonk in your n8n workflows. Now with improved AI Agent support and email validation fixes!

Listmonk is a self-hosted, high performance mailing list and newsletter manager. It comes as a standalone binary and the only dependency is a Postgres database.

Attribution

This package is based on the original n8n-nodes-listmonk created by Lucas Sovre ([email protected]). We've built upon his excellent foundation to add enhanced AI agent support, fix email validation issues, and improve overall functionality.

Package Overview

This package includes two node variants:

• Listmonk Node: Traditional workflow automation with full API access
• Listmonk Tool Node: AI-optimized for use with N8N AI agents and natural language interactions

Enhancements in this Version

• ✅ Fixed email validation: Resolved "invalid email" errors with proper regex patterns
• ✅ Enhanced AI agent tools: Improved parameter handling and tool registration
• ✅ Better error handling: More robust API error responses
• ✅ Updated documentation: Comprehensive testing and troubleshooting guides
• ✅ Code quality improvements: TypeScript fixes and better type safety

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
AI Tool Support
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

For AI Tool Support

Set the following environment variable to enable community packages as AI tools:

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

Operations

This node allows you to easily automate your Listmonk functionalities:

• Lists - Create, manage, and retrieve mailing lists
• Subscribers - Add, update, and manage email subscribers
• Campaigns - Create, send, and track email campaigns
• Media - Upload and manage media files
• Templates - Create and manage email templates
• Transactional - Send one-off transactional emails
• Utils - Health checks, configuration, and statistics

AI Tool Support

Listmonk Tool Node

The AI-optimized variant includes streamlined operations perfect for natural language interactions:

• Create Subscriber - Add new subscribers with AI-populated parameters
• Get Subscriber by Email - Find subscribers using natural language queries
• Update Subscriber - Modify subscriber information through AI commands
• Create & Send Campaigns - Build and deploy email campaigns via AI
• Manage Lists - Create and organize mailing lists
• Send Transactional Emails - Send immediate emails with AI assistance
• Get Statistics - Retrieve campaign and system performance data

Natural Language Examples

With the AI Tool node, you can use commands like:

• "Add [email protected] to our newsletter list"
• "Create a campaign about our new product launch"
• "Send a welcome email to new subscribers"
• "Get statistics for last week's campaign"
• "Update subscriber preferences for [email protected]"

The AI agent will automatically:

• Choose the appropriate operation
• Extract relevant information from your request
• Populate the required parameters
• Execute the API call

Credentials

The credentials use basic authentication. See the official API documentation for details.

Required fields:

• User: Your Listmonk username
• Password: Your Listmonk password
• Domain: Your Listmonk instance URL (e.g., https://listmonk.example.com)

Compatibility

• Minimum n8n version: 1.18.2
• AI Tool support: Requires N8N version with AI Agent support (1.50+)
• Tested versions: 1.18.2+

Usage

Traditional Workflows

Use the standard "Listmonk" node for traditional automation workflows with manual parameter configuration.

AI Agent Integration

1. Add an AI Agent node (Tools Agent recommended) to your workflow
2. Connect the "Listmonk Tool" as a tool
3. Configure your Listmonk credentials
4. Interact using natural language

Example AI Workflow

Chat Trigger → AI Agent (Tools Agent) → Listmonk Tool

The AI agent can now manage your email marketing through conversational commands!

Troubleshooting

If you encounter issues with email validation or AI agent tools, check out our comprehensive guides:

• TESTING.md - Testing procedures and examples
• DIAGNOSIS.md - Troubleshooting common issues

Resources

• n8n community nodes documentation
• Listmonk API documentation
• AI Tool Setup Guide
• N8N AI Agent Documentation

Contributing

For questions about the original functionality, please contact Lucas Sovre at [email protected].

For issues related to the enhancements (email validation, AI agent improvements), please open an issue on our repository.

Version history

• 1.0.10 : Fixed deleteSubscriber operation 404 error by correcting ID parameter handling
• 1.0.9 : Enhanced version with email validation fixes and improved AI agent tools
• 1.0.8 : Added AI Tool support with dedicated ListmonkTool node
• 1.0.7 : Enhanced standard node with usableAsTool property
• 1.0 : Initial release by Lucas Sovre with most API functionalities

License

MIT License - Based on original work by Lucas Sovre, enhanced by Fin.