listmonk integration
listmonk integration for AI agents.
listmonk integration for AI agents with secure authentication and server-side credential injection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves listmonk tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.
What your agents can do
Real listmonk actions, managed and audited.
Your user connects listmonk once; your agent can then use the listmonk API to manage subscribers, lists, campaigns, templates, media, bounces, settings, and transactional messages — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.
- 1
Your user grants listmonk access once (OAuth) — the token lands in the vault.
- 2
Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.
- 3
Every routed call appends a hash-chained audit record — nothing leaves your infra.
Tools & triggers
Supported listmonk tools.
72 tools are generated from the published listmonk catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.
Showing 72 tools. All published catalog entries are included in this page's server-rendered HTML.
- BlocklistSubscribersQuery
- bulk blocklists subscribers based on an arbitrary SQL expression.
- Subscribers
- CreateCampaign
- handles campaign creation
- Campaigns
- CreateCampaignContentById
- handles campaign content (body) format conversions.
- Campaigns
- CreateList
- handles list creation
- Lists
- CreateSubscriber
- handles creation of new subscriber
- Subscribers
- CreateTemplate
- handles template creation
- Templates
- DeleteBounceById
- handles bounce deletion, either a single one (ID in the URI), or a list.
- Bounces
- DeleteBounces
- handles deletion of bounce records.
- Bounces
- DeleteCampaignAnalyticsByType
- garbage collects (deletes) campaign analytics.
- Maintenance
- DeleteCampaignById
- deletes specified campaign
- Campaigns
- DeleteGCSubscribers
- garbage collects (deletes) orphaned or blocklisted subscribers.
- Maintenance
- DeleteListById
- handles list deletion, either a single one (ID in the URI), or a list.
- Lists
- DeleteMediaById
- handles deletion of uploaded media.
- Media
- DeleteSubscriberBouncesById
- deletes a subscriber's bounce records
- Subscribers
- DeleteSubscriberById
- handles subscriber deletion based on id
- Subscribers
- DeleteSubscriberByList
- handles subscribers deletion
- Subscribers
- DeleteSubscriberByQuery
- bulk deletes based on an arbitrary SQL expression.
- Subscribers
- DeleteTemplateById
- handles deletion of templates
- Templates
- DeleteUnconfirmedSubscriptions
- garbage collects (deletes) orphaned or blocklisted subscribers.
- Maintenance
- ExportSubscriberDataByID
- retrieves a subscriber's profile
- Subscribers
- GetBounceById
- handles retrieval of bounce record by id
- Bounces
- GetBounces
- handles retrieval of bounce records.
- Bounces
- GetCampaignAnalytics
- retrieves view counts for a campaign.
- Campaigns
- GetCampaignById
- handles retrieval of campaigns.
- Campaigns
- GetCampaigns
- handles retrieval of campaigns
- Campaigns
- GetDashboardCharts
- returns chart data points to render on the dashboard.
- Miscellaneous
- GetDashboardCounts
- returns stats counts to show on the dashboard
- Miscellaneous
- GetHealthCheck
- healthcheck endpoint
- Miscellaneous
- GetI18nLang
- returns the JSON language pack given the language code
- Miscellaneous
- GetImportSubscriberLogs
- returns import logs from an ongoing import
- Import
- GetImportSubscribers
- returns import status.
- Import
- GetListById
- retrieves lists with additional metadata like subscriber counts. This may be slow.
- Lists
- GetLists
- retrieves lists with additional metadata like subscriber counts. This may be slow.
- Lists
- GetLogs
- returns the log entries stored in the log buffer
- Logs
- GetMedia
- handles retrieval of uploaded media.
- Media
- GetMediaById
- handles retrieval of uploaded media.
- Media
- GetPublicLists
- returns the list of public lists with minimal fields
- Public
- GetRunningCampaignStats
- returns stats of a given set of campaign IDs.
- Campaigns
- GetServerConfig
- returns general server config.
- Miscellaneous
- GetSettings
- returns settings from DB
- Settings
- GetSubscriberBouncesById
- retrieves a subscriber's bounce records
- Subscribers
- GetSubscriberById
- handles the retrieval of a single subscriber by ID.
- Subscribers
- GetSubscribers
- returns all subscribers.
- Subscribers
- GetTemplateById
- handles retrieval of templates
- Templates
- GetTemplates
- handles retrieval of templates
- Templates
- HandlePublicSubscription
- handles subscription requests coming from public API calls.
- Public
- ImportSubscribers
- handles the uploading and bulk importing of a ZIP file of one or more CSV files.
- Import
- ManageBlocklistBySubscriberList
- handles blocklisting of subscriber list
- Subscribers
- ManageBlocklistSubscribersById
- handles the blocklisting of one or more subscribers.
- Subscribers
- ManageSubscriberListById
- handles bulk addition or removal of subscribers for a specified list id
- Subscribers
- ManageSubscriberLists
- handles bulk addition or removal of subscribers
- Subscribers
- ManageSubscriberListsByQuery
- bulk adds/removes/unsubscribes subscribers from one or more lists based on an arbitrary SQL expression.
- Subscribers
- PreviewCampaignById
- renders the HTML preview of a campaign body
- Campaigns
- PreviewCampaignTextById
- renders the HTML preview of a campaign body
- Campaigns
- PreviewTemplate
- get the HTML preview of a template.
- Templates
- PreviewTemplateById
- renders the HTML preview of a template.
- Templates
- ReloadApp
- restarts the app
- Admin
- SetDefaultTemplateById
- handles template modification.
- Templates
- StopImportSubscribers
- sends a stop signal to the importer.
- Import
- SubscriberSendOptinById
- sends an optin confirmation e-mail to a subscriber.
- Subscribers
- TestCampaignById
- handles sending of campaign message to arbitrary subscribers for testing
- Campaigns
- TestSMTPSettings
- test smtp settings
- Settings
- TransactWithSubscriber
- send message to a subscriber
- Transactional
- UpdateCampaignArchiveById
- handles campaign status modification
- Campaigns
- UpdateCampaignById
- handle updation of campaign
- Campaigns
- UpdateCampaignStatusById
- handles campaign status modification
- Campaigns
- UpdateListById
- handles list modification
- Lists
- UpdatePreviewCampaignById
- renders the HTML preview of a campaign body
- Campaigns
- UpdateSettings
- returns updated settings from the DB.
- Settings
- UpdateSubscriberById
- modify subscriber data
- Subscribers
- UpdateTemplateById
- handles template modification
- Templates
- UploadMedia
- handles media file uploads.
- Media
FAQ
listmonk integration, answered
- How do AI agents use listmonk through Open Connector?
- Your user connects listmonk once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes listmonk tools to your agent over MCP or a typed API, with credentials injected server-side on each call.
- Is this a listmonk MCP server?
- Yes. Open Connector can serve listmonk as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call listmonk actions with credentials injected server-side.
- Where do listmonk credentials live?
- In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.
Give your agents listmonk — keep the keys.
Open source, self-hostable, with listmonk credentials that never leave your infrastructure. Run it from source today.