mailexodus

Open source skill, CLI, and MCP server for planning email platform migrations through a portable automation schema.

mailexodus is an agent playbook generator, not an automatic migrator. It tells an agent what the source platform can export, what the destination platform can import, how to map portable objects, and which parts require manual review. The agent performs API reads and writes only after you approve the dry-run report.

The implementation is TypeScript in src/ and builds to dist/ for npm.

npx mailexodus@latest adapters
npx mailexodus@latest coverage
npx mailexodus@latest info klaviyo
npx mailexodus@latest plan --from klaviyo --to mailchimp
npx mailexodus@latest reference --from klaviyo --to mailchimp
npx mailexodus@latest guide --from klaviyo --to mailchimp

CLI

• mailexodus adapters lists supported source and destination adapters.
• mailexodus coverage prints every provider's source-export and destination-import coverage.
• mailexodus info klaviyo prints detailed source and destination coverage for one provider.
• mailexodus schema prints the portable schema.
• mailexodus plan --from klaviyo --to mailchimp returns migration stages, destination import checks, and manual review risks.
• mailexodus reference --from klaviyo --to mailchimp returns endpoint-level route detail: API paths, scopes, docs, mappings, review items, and blocked objects.
• mailexodus guide --from klaviyo --to mailchimp returns the full read -> map -> write agent playbook, including routeReference.

The CLI never writes provider data. Use coverage or info before planning because each source provider exposes a different mix of subscribers, lists, tags, segments, custom fields, suppressions, campaigns, templates, and automations, and each destination exposes a different import surface. For example, Klaviyo can expose flows, but Mailchimp does not expose a clean Customer Journey / automation graph import path, so mailexodus marks automations as manual for that route.

Development

pnpm --filter mailexodus build
pnpm --filter mailexodus test

MCP

Run the stdio MCP server:

npx -p mailexodus@latest mailexodus-mcp

Tools exposed:

• list_adapters
• provider_info
• coverage_overview
• plan_migration
• dry_run_migration
• migration_playbook
• route_reference
• show_schema

Skill

The bundled skill is in skill/SKILL.md. Copy or reference it from agents that should plan email platform migrations with mailexodus.