# Listmonk Newsletter Agent

> Write newsletters and ship them through self-hosted listmonk via its API — draft, test-send, schedule. Includes marketingskills emails + copywriting.

- Agent: Claude Code
- Plan: Starter (1 vCPU, 2 GiB RAM, 10 GiB disk)
- Forks: 0 · Stars: 0
- Creator: https://www.jurniti.com/creator-ca0ff2
- Tags: claude-code, email-marketing, listmonk, newsletter, self-hosted
- Skills: campaign-ship, copywriting, emails, listmonk, newsletter-write

**To fork:** open https://www.jurniti.com/templates/listmonk-newsletter-agent and use the Fork action — it starts a Stripe Checkout for a new VM seeded with this template's persist disk (same flat plan price, no fork fee).

## README

# Newsletter Agent (listmonk)

Operate a self-hosted [listmonk](https://github.com/knadh/listmonk) newsletter stack from Claude Code: draft issues, design email sequences, and ship campaigns via the listmonk admin API.

## What you get

- **listmonk** skill + `listmonk.sh` CLI — lists, subscribers, campaigns, test sends
- **newsletter-write** — single-issue craft (subject, body, CTA) + craft reference
- **emails** + **copywriting** — multi-email sequences and prose polish (from [marketingskills](https://github.com/coreyhaines31/marketingskills))
- **campaign-ship** — draft → test → schedule/send loop (never blasts without your yes)

## BYOK setup (run-time only — never write secrets into files)

1. Run [listmonk](https://listmonk.app/docs/installation/) somewhere you control; configure SMTP.
2. Create an API user + token (Admin → Users).
3. In the VM terminal:

```bash
export LISTMONK_URL=https://listmonk.example.com
export LISTMONK_USER=api_user
export LISTMONK_TOKEN   # paste token value into the env var only
```

4. Log into Claude Code with your own Anthropic account/key.
5. Ask: *"Draft a short weekly update, create a draft campaign, test-send to me@…"*

## Safety

Default is **draft + test-send**. Status `scheduled` / `running` only after you explicitly approve.