mailerlite

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.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "mailerlite" with this command: npx skills add mailerlite/mailerlite-skills/mailerlite-mailerlite-skills-mailerlite

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.

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:

Flag Description

--profile <name>

Select config profile

--verbose / -v

Show HTTP request/response details

--json

Output as machine-readable JSON

--yes / -y

Skip 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 user@example.com --json

Get subscriber count

mailerlite subscriber count --json

Get subscriber details (by ID or email)

mailerlite subscriber get user@example.com --json

Create or update a subscriber

mailerlite subscriber upsert
--email "user@example.com"
--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 "sender@yourdomain.com"
--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 "customer@example.com"
--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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Coding

Skill Creator (Opencode)

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize a...

Registry SourceRecently Updated
00pwu0125
Coding

Funnel Builder

Builds complete multi-channel revenue funnels adapted to any business model. Combines proven frameworks from elite operators: Yomi Denzel's viral top-of-funn...

Registry SourceRecently Updated
00georges91560
Coding

macos-wechat-send

Automates sending messages on WeChat Mac by controlling the app via AppleScript and clipboard to reliably deliver text to specified contacts.

Registry SourceRecently Updated
690sincerememe
Coding

Rednote CLI

Use when the user needs to publish, search, inspect, log into, or otherwise operate Xiaohongshu (RedNote) from the terminal with the `@skills-store/rednote`...

Registry SourceRecently Updated
3101DarkNoah