mailcoach

Manage Mailcoach email lists, subscribers, campaigns, and transactional emails via CLI.

999|201|Updated May 6, 2014
One-click install
npx skills add https://github.com/freekmurze/dotfiles --skill mailcoach
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mailcoach
Source: https://github.com/freekmurze/dotfiles/tree/main/config/claude/skills/mailcoach
Command: npx skills add https://github.com/freekmurze/dotfiles --skill mailcoach

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Managing email marketing operations in a self-hosted Mailcoach instance normally requires clicking through the web UI or hand-writing API calls. This Skill lets you operate lists, subscribers, campaigns, templates, and automations directly through the auto-generated Mailcoach CLI.

Core Features & Use Cases

  • List and Subscriber Management: Create email lists, import subscribers in bulk via CSV, manage tags, segments, and global suppressions.
  • Campaign Lifecycle: Create draft campaigns, set HTML content, send test emails, send to the full list, and view open, click, bounce, and unsubscribe statistics.
  • Transactional Emails & Automations: Send transactional emails via templates or inline content, and trigger webhook-based automations for specific subscribers.
  • Use Case: You want to launch a monthly newsletter. Create an email list, import your subscriber CSV, build a campaign from a template, send a test to yourself, then send the campaign and check its open statistics — all from the command line.

Quick Start

Ask the assistant to list your Mailcoach email lists, then create a draft campaign for one of them and send a test email to your address.

Frequently Asked Questions about mailcoach

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an email campaign with the Mailcoach CLI?

Create a draft with mailcoach create-campaign, set content via update-campaign, send a test with send-campaign-test, then run send-campaign with the campaign UUID. Use --json to capture UUIDs between steps.

How do I import subscribers into a Mailcoach email list?

Use create-subscriber-import with a subscribers_csv payload, optionally append more rows with append-subscriber-import, then run start-subscriber-import. Flags control resubscribing, unsubscribing others, and tag replacement.

Does the Mailcoach CLI work with self-hosted instances?

Yes. During mailcoach login you choose Mailcoach Cloud (team name) or a self-hosted instance with a full URL. Credentials and the instance URL are stored in ~/.mailcoach/config.json.

Why does the Mailcoach CLI return a 401 error?

A 401 means the API token is invalid or expired. Run mailcoach login again to re-authenticate, then verify with any list command such as mailcoach list-email-lists.

Can I trigger Mailcoach automations from the command line?

Yes, but only automations configured with a webhook trigger in the Mailcoach UI. Use trigger-automation with the automation UUID and a list of subscriber UUIDs to enter them into the flow.