agentsclimarketplace

Mailerlite cli

Skill mailerlite/mailerlite-skills/skills/mailerlite-cli

This skill should be used when the user asks to "manage subscribers", "create a campaign", "list automations", "manage groups", "manage forms", "manage segments", "manage fields", "manage webhooks", "list timezones", "manage e-commerce shops", "manage products", "manage categories", "manage customers", "manage orders", "manage carts", "manage cart items", "import e-commerce data", "switch mailerlite account", "configure mailerlite", "set up mailerlite profile", "launch the mailerlite dashboard", or any task involving the MailerLite email marketing platform via CLI. Provides comprehensive guidance for using the `mailerlite` command-line tool.From its SKILL.md

Install
npx -y skills add mailerlite/mailerlite-skills --skill mailerlite-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

12.3 KB, as published. Nobody here has run it

MailerLite CLI

The MailerLite CLI (mailerlite) is a command-line tool and interactive TUI dashboard for the MailerLite email marketing API. It supports managing subscribers, campaigns, automations, groups, forms, segments, fields, webhooks, e-commerce (shops, products, categories, customers, orders, carts), and full account management.

Check CLI Availability First

Before running any commands, verify the CLI is installed:

command -v mailerlite

If the binary is not available, do not guess at commands. Either offer to install it (see Installation below), or use another available MailerLite interface instead — the MailerLite MCP server, if connected, or the REST API directly.

Installation

Install via Homebrew, Nix, or download a binary from GitHub releases:

# Homebrew
brew install --cask mailerlite/tap/mailerlite

# Nix flake
nix profile install github:mailerlite/mailerlite-cli

# Or download from https://github.com/mailerlite/mailerlite-cli/releases

The binary is called mailerlite.

Authentication

Before using the CLI, authenticate with MailerLite:

# Interactive login (prompts for method — OAuth or API token)
mailerlite auth login

# Direct token login
mailerlite auth login --method token --token "your_token_here"

# Check authentication status
mailerlite auth status

Multi-Profile Support

Manage multiple accounts or tokens with named profiles:

mailerlite profile add production --token "prod_token"
mailerlite profile add staging --token "staging_token"
mailerlite profile switch production
mailerlite profile list

Use --profile <name> on any command to override the active profile.

Multi-Account Support

If your OAuth credentials have access to multiple accounts:

mailerlite account list
mailerlite account switch <account_id>

Token resolution order: MAILERLITE_API_TOKEN env var > --profile flag > active profile > first profile.

Config is stored at ~/.config/mailerlite/config.yaml.

Global Flags

These flags work on all commands:

FlagDescription
--profile <name>Select config profile
--verbose / -vShow HTTP request/response details
--jsonOutput as machine-readable JSON
--yes / -ySkip confirmation prompts

The CLI respects the NO_COLOR environment variable.

Critical: Always Use JSON Output

When executing mailerlite commands, always append --json to every command. JSON output is structured and parseable, making it reliable for extracting IDs, statuses, and other data needed for follow-up commands. The default table output is for human reading only and difficult to parse programmatically.

# Correct - always use --json
mailerlite subscriber list --json
mailerlite campaign get <id> --json

# Incorrect - table output is hard to parse
mailerlite subscriber list

The only exceptions are dashboard (interactive TUI), completion (shell scripts), and simple write confirmations.

Core Workflows

Managing Subscribers

# List subscribers
mailerlite subscriber list --json
mailerlite subscriber list --status active --email [email protected] --json

# Get subscriber count
mailerlite subscriber count --json

# Get subscriber details (by ID or email)
mailerlite subscriber get [email protected] --json

# Create or update a subscriber
mailerlite subscriber upsert \
  --email "[email protected]" \
  --status active \
  --groups "group_id_1,group_id_2" \
  --fields '{"name":"John","company":"Acme"}' --json

# Update a subscriber
mailerlite subscriber update <id> --status unsubscribed --json

# Delete a subscriber
mailerlite subscriber delete <id>

# Forget a subscriber (GDPR)
mailerlite subscriber forget <id>

Managing Campaigns

# List campaigns
mailerlite campaign list --json
mailerlite campaign list --status sent --type regular --json

# Get campaign details
mailerlite campaign get <campaign_id> --json

# Create a campaign
mailerlite campaign create \
  --name "Welcome Campaign" \
  --type regular \
  --subject "Welcome!" \
  --from "[email protected]" \
  --from-name "Sender Name" \
  --content "<h1>Hello</h1>" \
  --groups "group_id" --json

# Schedule a campaign
mailerlite campaign schedule <campaign_id> \
  --delivery scheduled \
  --date 2026-03-01 \
  --hours 10 \
  --minutes 0

# Cancel a campaign
mailerlite campaign cancel <campaign_id>

# List campaign subscriber activity
mailerlite campaign subscribers <campaign_id> --json

# List available campaign languages
mailerlite campaign languages --json

# Delete a campaign
mailerlite campaign delete <campaign_id>

Managing Groups

mailerlite group list --json                                    # List groups
mailerlite group create --name "Newsletter" --json              # Create group
mailerlite group update <id> --name "Weekly Newsletter" --json  # Update group
mailerlite group delete <id>                                    # Delete group
mailerlite group subscribers <group_id> --json                  # List subscribers in group
mailerlite group assign <group_id> <subscriber_id>              # Assign subscriber
mailerlite group unassign <group_id> <subscriber_id>            # Unassign subscriber

Managing Automations

mailerlite automation list --json                       # List automations
mailerlite automation list --enabled true --json        # Filter by enabled
mailerlite automation get <id> --json                   # Get automation details
mailerlite automation subscribers <id> --json           # List subscriber activity

Managing Forms

mailerlite form list --json                             # List forms
mailerlite form list --type popup --json                # Filter by type
mailerlite form get <id> --json                         # Get form details
mailerlite form update <id> --name "Updated" --json     # Update form
mailerlite form delete <id>                             # Delete form
mailerlite form subscribers <id> --json                 # List form subscribers

Managing Fields

mailerlite field list --json                            # List subscriber fields
mailerlite field create --name "Company" --type text --json  # Create field
mailerlite field update <id> --name "Organization" --json    # Update field
mailerlite field delete <id>                            # Delete field

Managing Segments

mailerlite segment list --json                          # List segments
mailerlite segment update <id> --name "VIP" --json      # Update segment
mailerlite segment delete <id>                          # Delete segment
mailerlite segment subscribers <id> --json              # List subscribers

Managing Webhooks

mailerlite webhook list --json                          # List webhooks
mailerlite webhook get <id> --json                      # Get webhook details
mailerlite webhook create \
  --name "My Webhook" \
  --url "https://example.com/webhook" \
  --events "subscriber.created,campaign.sent" \
  --enabled --json                                      # Create webhook
mailerlite webhook update <id> --name "Updated" --json  # Update webhook
mailerlite webhook delete <id>                          # Delete webhook

E-Commerce: Shops

mailerlite shop list --json                             # List shops
mailerlite shop get <id> --json                         # Get shop details
mailerlite shop create --name "My Store" --url "https://mystore.com" --json
mailerlite shop update <id> --name "Updated" --json     # Update shop
mailerlite shop delete <id>                             # Delete shop
mailerlite shop count --json                            # Get shop count

E-Commerce: Products

All product commands require --shop <shop_id>.

mailerlite product list --shop <shop_id> --json
mailerlite product get <product_id> --shop <shop_id> --json
mailerlite product create --shop <shop_id> \
  --name "T-Shirt" --price 29.99 \
  --url "https://mystore.com/tshirt" --json
mailerlite product update <product_id> --shop <shop_id> --price 24.99 --json
mailerlite product delete <product_id> --shop <shop_id>
mailerlite product count --shop <shop_id> --json

E-Commerce: Categories

All category commands require --shop <shop_id>.

mailerlite category list --shop <shop_id> --json
mailerlite category get <id> --shop <shop_id> --json
mailerlite category create --shop <shop_id> --name "Apparel" --json
mailerlite category update <id> --shop <shop_id> --name "Clothing" --json
mailerlite category delete <id> --shop <shop_id>
mailerlite category count --shop <shop_id> --json
mailerlite category products <id> --shop <shop_id> --json
mailerlite category assign-product <id> --shop <shop_id> --product <product_id>
mailerlite category unassign-product <id> --shop <shop_id> --product <product_id>

E-Commerce: Customers

All customer commands require --shop <shop_id>.

mailerlite customer list --shop <shop_id> --json
mailerlite customer get <id> --shop <shop_id> --json
mailerlite customer create --shop <shop_id> \
  --email "[email protected]" \
  --first-name "John" --last-name "Doe" --json
mailerlite customer update <id> --shop <shop_id> --first-name "Jane" --json
mailerlite customer delete <id> --shop <shop_id>
mailerlite customer count --shop <shop_id> --json

E-Commerce: Orders

All order commands require --shop <shop_id>.

mailerlite order list --shop <shop_id> --json
mailerlite order get <id> --shop <shop_id> --json
mailerlite order create --shop <shop_id> \
  --customer <customer_id> --status complete \
  --total 59.98 --currency USD \
  --items '[{"product_id":"prod1","quantity":2,"price":29.99}]' --json
mailerlite order update <id> --shop <shop_id> --status complete --json
mailerlite order delete <id> --shop <shop_id>
mailerlite order count --shop <shop_id> --json

E-Commerce: Carts & Cart Items

# Carts (require --shop)
mailerlite cart list --shop <shop_id> --json
mailerlite cart get <id> --shop <shop_id> --json
mailerlite cart update <id> --shop <shop_id> --currency EUR --json
mailerlite cart count --shop <shop_id> --json

# Cart items (require --shop and --cart)
mailerlite cart-item list --shop <shop_id> --cart <cart_id> --json
mailerlite cart-item create --shop <shop_id> --cart <cart_id> \
  --product <product_id> --quantity 2 --price 29.99 --json
mailerlite cart-item update <item_id> --shop <shop_id> --cart <cart_id> --quantity 3 --json
mailerlite cart-item delete <item_id> --shop <shop_id> --cart <cart_id>
mailerlite cart-item count --shop <shop_id> --cart <cart_id> --json

E-Commerce: Bulk Import

mailerlite import categories --shop <shop_id> --file categories.json --json
mailerlite import products --shop <shop_id> --file products.json --json
mailerlite import orders --shop <shop_id> --file orders.json --json

TUI Dashboard

mailerlite dashboard

Launch an interactive terminal dashboard with sidebar navigation, real-time data, and vim-style keybindings (j/k to navigate, Enter to select, ? for help, q to quit).

Key Patterns

  • Pagination: Use --limit <n> to control results. --limit 0 fetches all results.
  • Interactive mode: Omit required flags and the CLI prompts interactively.
  • JSON output: Append --json to any command for machine-readable output.
  • E-commerce nesting: Products, categories, customers, orders, and carts are nested under shops via --shop <shop_id>. Cart items require both --shop and --cart.

Additional Resources

Reference Files

For the complete command reference with all subcommands and flags, consult:

  • references/command-reference.md - Full command tree for all 20+ command groups with every flag documented

Keep looking

Skills are one crate of 609,689. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.