A newsletter you run on your own server

Docs

Agents and the CLI

The mailpiece CLI works with your install from a terminal, and is also an MCP server and an agent skill.

Paste this into your agent

Install the mailpiece CLI and connect it to my newsletter. Read mailpiece.dev/docs/agents.md first.

Install and sign in

Build with Go; the binary lands in bin/mailpiece. Put it on your PATH.

Make a token under Profile › Personal access tokens: read only looks, read and write can change things. --account is the number in the app's address.

git clone https://github.com/mailpiece/mailpiece-cli.git
cd mailpiece-cli
make build

mailpiece auth login TOKEN --account 834206594 --api-url https://app.example.com
mailpiece doctor

MCP

mailpiece mcp serves the newsletter as MCP tools over stdio. It only reads unless you pass --writes, with a read and write token.

--domains narrows the tools: posts, search, subscribers, snippets, journeys, settings, users, identity and access_tokens. Setups per agent are on the integrations pages.

claude mcp add mailpiece -- mailpiece mcp
claude mcp add mailpiece -- mailpiece mcp --writes
claude mcp add mailpiece -- mailpiece mcp --domains posts,subscribers

The skill

Installs the CLI's agent skill for coding agents, refreshed when the CLI is upgraded. Bare mailpiece skill asks where to put it.

mailpiece skill install

Careful with sending

mailpiece post deliver mails the whole list and cannot be undone. mailpiece post test mails one address.

Still need help? Ask on GitHub.