Connect Listmonk to Your AI Agent

Check the newsletter’s message and audience before the next send.

28 tools API key

Try a Listmonk Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Listmonk

Review campaign results

Read an existing campaign’s body, target lists, status, and delivery counters.

/oo Listmonk: Find listmonk campaign [name] and read its content. Summarize the message, target lists, current state, and available delivery results.

Start Working with Listmonk

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Listmonk

    Connect your public instance URL, API username, and API token.

    Connect Listmonk →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A public HTTP or HTTPS listmonk instance.
  • An API user and token with permissions for the requested operations.

Listmonk Tools

Work with subscribers, mailing lists, templates, and campaigns on your public listmonk instance. Campaign reviews bring the body, audience, state, and available delivery results together, with sending handled as a separate request.

Campaign and subscriber lookup

Read campaign content and delivery counters and inspect subscriber attributes and list memberships.

28 tools

List Subscribers

Query listmonk subscribers, optionally filtered by list membership and an SQL expression over the subscribers table, with paging.

listmonk.list_subscribers

Get Subscriber

Fetch one listmonk subscriber with attributes and list subscriptions.

listmonk.get_subscriber

Create Subscriber

Create a listmonk subscriber and optionally subscribe it to lists. Double opt-in lists send a confirmation email unless preconfirmSubscriptions is true.

listmonk.create_subscriber

Update Subscriber

Update one listmonk subscriber. Only the provided fields change: the current subscriber is read first and merged, so omitted fields and list subscriptions are preserved. Passing listIds replaces the subscriber's list subscriptions; attribs replaces all attributes. Unless preconfirmSubscriptions is true, an instance with opt-in confirmations enabled emails the subscriber again for every double opt-in list that is still unconfirmed.

listmonk.update_subscriber

Delete Subscriber

Permanently delete one listmonk subscriber and its subscriptions.

listmonk.delete_subscriber

Manage Subscriber Lists

Add subscribers to lists, remove them from lists, or mark their subscriptions as unsubscribed. status is required when action is add.

listmonk.manage_subscriber_lists

Blocklist Subscribers

Blocklist one or more listmonk subscribers. Blocklisted subscribers are unsubscribed from every list and never receive campaigns.

listmonk.blocklist_subscribers

List Lists

List listmonk mailing lists with subscriber counts, optionally filtered by name, status, or tags.

listmonk.list_lists

Get List

Fetch one listmonk list.

listmonk.get_list

Create List

Create a listmonk mailing list.

listmonk.create_list

Update List

Update one listmonk list. Only the provided fields change; the current name and tags are preserved when omitted.

listmonk.update_list

List Templates

List listmonk templates (campaign, visual campaign, and transactional) to pick a templateId for campaigns.

listmonk.list_templates

Get Template

Fetch one listmonk template including its body.

listmonk.get_template

List Campaigns

List listmonk campaigns, optionally filtered by a name/subject search, statuses, or tags, with paging.

listmonk.list_campaigns

Get Campaign

Fetch one listmonk campaign with its status, schedule, target lists, body, and delivery counters.

listmonk.get_campaign

Create Campaign

Create a listmonk campaign as a draft. Nothing is sent: use send_campaign_test to preview it by email, then schedule_campaign or start_campaign to send it. Setting sendAt here only stores the time; the campaign is not scheduled until schedule_campaign runs.

listmonk.create_campaign

Update Campaign

Update a draft, scheduled, or paused listmonk campaign. Only the provided fields change; target lists and attachments are preserved unless listIds is given. Pass sendAt null to clear a stored send time; listmonk rejects every update while the stored send time is in the past.

listmonk.update_campaign

Delete Campaign

Permanently delete one listmonk campaign.

listmonk.delete_campaign

Get Campaign Preview

Render the campaign body inside its template and return the HTML preview, exactly as recipients would see it.

listmonk.get_campaign_preview

Send Campaign Test

Send the campaign as it is currently saved to specific test addresses only (not to the lists). Each address must already exist as a subscriber in listmonk.

listmonk.send_campaign_test

Schedule Campaign

Schedule a draft or paused campaign to be sent automatically at sendAt: stores sendAt on the campaign, then changes its status to scheduled. A campaign that is already scheduled is simply moved to the new time. SENDS EMAIL TO ALL SUBSCRIBERS OF THE TARGET LISTS - confirm with the user before executing.

listmonk.schedule_campaign

Unschedule Campaign

Unschedule a scheduled campaign by moving it back to draft, so it is not sent at its sendAt. The stored sendAt is kept; only scheduled campaigns can be unscheduled.

listmonk.unschedule_campaign

Start Campaign

Start sending a draft or paused campaign immediately (status running); a paused campaign resumes where it stopped. SENDS EMAIL TO ALL SUBSCRIBERS OF THE TARGET LISTS - confirm with the user before executing.

listmonk.start_campaign

Pause Campaign

Pause a running campaign. It can be resumed later with start_campaign. Only running campaigns can be paused.

listmonk.pause_campaign

Cancel Campaign

Cancel a running or paused campaign permanently. A cancelled campaign cannot be resumed.

listmonk.cancel_campaign

Get Running Campaign Stats

Fetch live delivery stats (sent, to_send, rate, started_at) for currently running campaigns, optionally narrowed to specific campaign IDs.

listmonk.get_running_campaign_stats

Get Campaign Analytics

Fetch campaign analytics over a date range: daily view, click, or bounce counts, or per-link click counts (type links).

listmonk.get_campaign_analytics

Get Profile

Fetch the listmonk user profile of the connected API user, including its role and permissions.

listmonk.get_profile

Frequently Asked Questions

Does reviewing a campaign send it?

No. Sending is a separate operation.

Can adding a subscriber send a confirmation?

Yes. Double opt-in lists can send a confirmation email when a subscriber is added.

Connect Listmonk

About Listmonk ↗