Documentation

n8n-nodes-listmonk

This is a n8n community node that lets you use Listmonk in your n8n workflows. Now with AI Agent support!

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.

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

If you need more functionalities not implemented yet, do not hesitate to reach me out on [email protected]

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:

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!

Resources

Version history

  • 1.0.8 : Added AI Tool support with dedicated ListmonkTool node
  • 1.0.7 : Enhanced standard node with usableAsTool property
  • 1.0 : Initial release with most API functionalities

Discussion