✓ Verified 💻 Development ✓ Enhanced Data

Migma

Generate, send, validate, and export AI-powered emails from the terminal; manage contacts, segments,

Rating: 4.6 (123 reviews)
Downloads: 22,895 downloads
Version: 1.0.0

Overview

Generate, send, validate, and export AI-powered emails from the terminal; manage contacts, segments, tags, domains.

Complete Documentation

View Source →

Migma

Create and send professional, on-brand emails with AI. Your agent can design emails from a prompt, send them instantly through a managed domain, and manage an entire audience — all from the terminal.

Always pass --json for structured output.

First-time setup

If the user hasn't set up yet, run these steps once:

bash

# 1. Create an instant sending domain (no DNS needed)
migma domains managed create <companyname> --json
# → Sends from: hello@<companyname>.migma.email

# 2. Set a default project (brand)
migma projects list --json
migma projects use <projectId>

Create an email

When the user asks to create, design, or generate an email:

bash

migma generate "Welcome email for new subscribers" --wait --json

The --wait flag blocks until the AI finishes. The JSON response includes conversationId, subject, and html.

To save the HTML locally, add --save ./email.html. To include a reference image (screenshot, design mockup), add --image .

Send an email

When the user asks to send an email to someone:

bash

# Send a generated email directly
migma send --to [email protected] --subject "Welcome!" \
  --from-conversation <conversationId> \
  --from [email protected] --from-name "Company" --json

# Or send from a local HTML file
migma send --to [email protected] --subject "Hello" \
  --html ./email.html \
  --from [email protected] --from-name "Company" --json

# Send to an entire segment or tag
migma send --segment <id> --subject "Big News" --html ./email.html \
  --from [email protected] --from-name "Company" --json

# Personalize with template variables
migma send --to [email protected] --subject "Hi {{name}}" --html ./email.html \
  --from [email protected] --from-name "Company" \
  --var name=Sarah --var discount=20 --json

--from-conversation auto-exports the HTML from a generated email — no separate export step.

Validate an email

When the user wants to check an email before sending:

bash

migma validate all --html ./email.html --json
migma validate all --conversation <conversationId> --json

Returns an overall score plus individual checks: compatibility (30+ email clients), broken links, spelling/grammar, and deliverability/spam score. Individual checks: migma validate compatibility, links, spelling, deliverability.

Export to platforms

When the user wants to export to an ESP or download a file:

bash

migma export html <conversationId> --output ./email.html
migma export klaviyo <conversationId> --json
migma export mailchimp <conversationId> --json
migma export hubspot <conversationId> --json
migma export pdf <conversationId> --json
migma export mjml <conversationId> --json

Manage contacts

bash

migma contacts add --email [email protected] --firstName John --json
migma contacts list --json
migma contacts import ./contacts.csv --json
migma contacts remove <id> --json

Manage tags and segments

bash

migma tags create --name "VIP" --json
migma tags list --json
migma segments create --name "Active Users" --description "..." --json
migma segments list --json

Import a brand

When the user wants to set up a new brand from their website:

bash

migma projects import https://yourbrand.com --wait --json
migma projects use <projectId>

This fetches logos, colors, fonts, and brand voice automatically.

Error handling

On error, --json returns:

json

{"error": {"message": "Not found", "code": "not_found", "statusCode": 404}}

Installation

Terminal bash


openclaw install migma

Copied!

💻Code Examples

migma projects use <projectId>

migma-projects-use-projectid.txt

## Create an email

When the user asks to create, design, or generate an email:

migma generate "Welcome email for new subscribers" --wait --json

migma-generate-welcome-email-for-new-subscribers---wait---json.txt

The `--wait` flag blocks until the AI finishes. The JSON response includes `conversationId`, `subject`, and `html`.

To save the HTML locally, add `--save ./email.html`. To include a reference image (screenshot, design mockup), add `--image <url>`.

## Send an email

When the user asks to send an email to someone:

--var name=Sarah --var discount=20 --json

---var-namesarah---var-discount20---json.txt

`--from-conversation` auto-exports the HTML from a generated email — no separate export step.

## Validate an email

When the user wants to check an email before sending:

migma validate all --conversation <conversationId> --json

migma-validate-all---conversation-conversationid---json.txt

Returns an overall score plus individual checks: compatibility (30+ email clients), broken links, spelling/grammar, and deliverability/spam score. Individual checks: `migma validate compatibility`, `links`, `spelling`, `deliverability`.

## Export to platforms

When the user wants to export to an ESP or download a file:

migma segments list --json

migma-segments-list---json.txt

## Import a brand

When the user wants to set up a new brand from their website:

migma projects use <projectId>

migma-projects-use-projectid.txt

This fetches logos, colors, fonts, and brand voice automatically.

## Error handling

On error, `--json` returns:

example.sh

# 1. Create an instant sending domain (no DNS needed)
migma domains managed create <companyname> --json
# → Sends from: hello@<companyname>.migma.email

# 2. Set a default project (brand)
migma projects list --json
migma projects use <projectId>

example.sh

# Send a generated email directly
migma send --to [email protected] --subject "Welcome!" \
  --from-conversation <conversationId> \
  --from [email protected] --from-name "Company" --json

# Or send from a local HTML file
migma send --to [email protected] --subject "Hello" \
  --html ./email.html \
  --from [email protected] --from-name "Company" --json

# Send to an entire segment or tag
migma send --segment <id> --subject "Big News" --html ./email.html \
  --from [email protected] --from-name "Company" --json

# Personalize with template variables
migma send --to [email protected] --subject "Hi {{name}}" --html ./email.html \
  --from [email protected] --from-name "Company" \
  --var name=Sarah --var discount=20 --json

example.sh

migma export html <conversationId> --output ./email.html
migma export klaviyo <conversationId> --json
migma export mailchimp <conversationId> --json
migma export hubspot <conversationId> --json
migma export pdf <conversationId> --json
migma export mjml <conversationId> --json

example.sh

migma contacts add --email [email protected] --firstName John --json
migma contacts list --json
migma contacts import ./contacts.csv --json
migma contacts remove <id> --json