MailerLite Automation
Scannednpx machina-cli add skill ComposioHQ/awesome-claude-skills/mailerlite-automation --openclawMailerLite Automation
Automate email marketing operations -- manage subscribers, analyze campaign performance, organize groups and segments, and monitor account health -- all orchestrated through the Composio MCP integration.
Toolkit docs: composio.dev/toolkits/mailerlite
Setup
- Connect your MailerLite account through the Composio MCP server at
https://rube.app/mcp - The agent will prompt you with an authentication link if no active connection exists
- Once connected, all
MAILERLITE_*tools become available for execution
Core Workflows
1. Verify Account & Fetch Metadata
Retrieve account details including plan limits and timezone to ensure consistent reporting.
Tool: MAILERLITE_GET_ACCOUNT_INFO
No parameters required -- returns account metadata, plan details, and timezone configuration.
Always run this first to establish plan constraints and timezone for consistent time-windowed queries.
2. Get Account-Wide Performance Stats
Retrieve aggregate subscriber counts, sent email totals, and engagement metrics for a health snapshot.
Tool: MAILERLITE_GET_ACCOUNT_STATS
No parameters required -- returns overall subscriber counts, sent emails, and performance metrics.
3. List & Paginate Subscribers
Retrieve subscribers with optional status filtering and cursor-based pagination.
Tool: MAILERLITE_GET_SUBSCRIBERS
| Parameter | Type | Required | Description |
|---|---|---|---|
filter[status] | string | No | Filter by: active, unsubscribed, unconfirmed, bounced, junk |
limit | integer | No | Subscribers per page (default: 25) |
cursor | string | No | Pagination cursor from previous response meta.cursor |
include | string | No | Set to groups to include group memberships |
Important: Loop with meta.next_cursor until null to build a complete subscriber list.
4. List & Analyze Campaigns
Retrieve campaigns with optional status/type filters and page-based pagination.
Tool: MAILERLITE_GET_CAMPAIGNS
| Parameter | Type | Required | Description |
|---|---|---|---|
filter[status] | string | No | Filter by: sent, draft, ready |
filter[type] | string | No | Filter by: regular, ab, resend, rss |
limit | integer | No | Items per page (default: 25) |
page | integer | No | Page number (default: 1) |
Important: Paginate using meta.last_page to avoid omitting campaigns from historical analysis.
5. Manage Subscriber Groups
List, filter, and sort subscriber groups for audience organization.
Tool: MAILERLITE_GET_GROUPS
| Parameter | Type | Required | Description |
|---|---|---|---|
filter[name] | string | No | Partial name match filter |
limit | integer | No | Max groups to return |
page | integer | No | Page number (starting from 1) |
sort | string | No | Sort by: name, total, open_rate, click_rate, created_at (prefix - for descending) |
6. Retrieve Audience Segments & Custom Fields
Fetch segments and custom field definitions for advanced audience analysis.
Tools: MAILERLITE_GET_SEGMENTS and MAILERLITE_GET_FIELDS
Segments:
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Max segments to return (max 250) |
page | integer | No | Page number (starting from 1) |
Fields: No parameters required -- returns all custom field definitions.
Known Pitfalls
| Pitfall | Details |
|---|---|
| Subscriber pagination is cursor-based | MAILERLITE_GET_SUBSCRIBERS uses meta.next_cursor -- you must loop until null or counts will be incomplete |
| Campaign pagination is page-based | MAILERLITE_GET_CAMPAIGNS uses page/limit with meta.last_page -- stopping early omits campaigns and distorts trends |
| Sampling bias | Computing engagement metrics from only the first page introduces bias; always aggregate across all pages |
| Nested response shape | MailerLite payloads are nested under results[i].response.data with data and meta subkeys, not a flat data key -- parse accordingly |
| API quotas | Subscriber listing is limited by MailerLite Connect API quotas -- plan batch operations accordingly |
Quick Reference
| Tool Slug | Purpose |
|---|---|
MAILERLITE_GET_ACCOUNT_INFO | Verify auth and review account metadata |
MAILERLITE_GET_ACCOUNT_STATS | Get aggregate performance metrics |
MAILERLITE_GET_SUBSCRIBERS | List subscribers with filtering and pagination |
MAILERLITE_GET_CAMPAIGNS | List campaigns with status/type filters |
MAILERLITE_GET_GROUPS | List and sort subscriber groups |
MAILERLITE_GET_SEGMENTS | List audience segments |
MAILERLITE_GET_FIELDS | Retrieve custom field definitions |
Powered by Composio
Source
git clone https://github.com/ComposioHQ/awesome-claude-skills/blob/master/composio-skills/mailerlite-automation/SKILL.mdView on GitHub Overview
Automates MailerLite operations—managing subscribers, analyzing campaigns, organizing groups and segments, and monitoring account health through the Composio MCP integration. It exposes MAILERLITE_* tools to fetch account metadata, subscriber lists, campaigns, groups, and fields for scalable email management. This helps teams maintain healthy lists and optimize performance at scale.
How This Skill Works
The skill connects your MailerLite account via the Composio MCP. It first fetches account info to establish limits and timezone, then uses a set of MAILERLITE_* tools to pull subscribers, campaigns, groups, segments, and fields. For subscribers it uses cursor-based pagination (meta.next_cursor); for campaigns it uses page-based pagination (meta.last_page) to ensure complete historical coverage.
When to Use It
- When auditing account health: verify plan limits and timezone to ensure accurate reporting.
- When evaluating overall engagement: pull account stats and campaign performance metrics.
- When organizing audiences: list and filter groups and segments for targeted campaigns.
- When building subscriber lists: paginate through large subscriber sets and map group memberships.
- When enriching personalization: fetch segments and custom fields to tailor content.
Quick Start
- Step 1: Connect your MailerLite account through the Composio MCP server at https://rube.app/mcp
- Step 2: Run MAILERLITE_GET_ACCOUNT_INFO to initialize context (limits, timezone)
- Step 3: Start querying data with MAILERLITE_GET_SUBSCRIBERS and MAILERLITE_GET_CAMPAIGNS, handling pagination as needed
Best Practices
- Always run MAILERLITE_GET_ACCOUNT_INFO first to establish constraints and timezone.
- Paginate subscribers using the meta.next_cursor until it returns null.
- Use include=groups when pulling subscribers to capture group memberships.
- Paginate campaigns with meta.last_page to avoid missing historical data.
- Fetch segments (MAILERLITE_GET_SEGMENTS) and fields (MAILERLITE_GET_FIELDS) for accurate personalization.
Example Use Cases
- Audit account constraints (plan, timezone) and set reporting windows accordingly.
- Pull a full subscriber list with their group memberships for cleanup or re-engagement campaigns.
- Analyze campaign performance across time by listing campaigns with status/type filters and proper pagination.
- Create audience segments and map custom fields to personalize emails at scale.
- Validate field definitions to ensure correct data-driven personalization in campaigns.
