Skip to main content
Migma skills let AI coding assistants create, update, test, send, and schedule emails with Migma. They can also set up Migma inside an existing app by auditing current email triggers, creating the missing Migma emails, and wiring safe backend sends. For OpenClaw, see the dedicated OpenClaw page. For the short app-wiring guide, see /setup.

Guided agent install

Install paths for supported editors and agents

Natural language

Ask your agent to handle transactional emails and campaigns

Full API access

Create, edit, send, campaign, and manage contacts

Installation

Use the skills CLI when it is available for your agent:
Install script
curl -fsSL https://migma.ai/skills | sh
npx skills add MigmaAI/migma-skills
This works with Claude Code, Cursor, Codex, OpenCode, and 35+ other agents.

Install to a specific agent

npx skills add MigmaAI/migma-skills -a claude-code
npx skills add MigmaAI/migma-skills -a cursor
npx skills add MigmaAI/migma-skills -a codex

Install one workflow

npx skills add MigmaAI/migma-skills --skill migma
npx skills add MigmaAI/migma-skills --skill setup

Install globally (all projects)

npx skills add MigmaAI/migma-skills -g

Install as a plugin

Add the marketplace once, then install the Migma plugin in your agent.
https://mintcdn.com/migmaai/QHH_kDlhE97DvfUZ/images/logos/claude-color.svg?fit=max&auto=format&n=QHH_kDlhE97DvfUZ&q=85&s=87dfd67137723cac140274a92b596a9c

Claude Code

claude plugin marketplace add MigmaAI/migma-skills
claude plugin install migma@migma-plugins
https://mintcdn.com/migmaai/QHH_kDlhE97DvfUZ/images/logos/openai.svg?fit=max&auto=format&n=QHH_kDlhE97DvfUZ&q=85&s=acbaf5092a31aafd865b5c726ce593ff

Codex

codex plugin marketplace add MigmaAI/migma-skills
codex plugin add migma@migma-plugins
https://mintcdn.com/migmaai/QHH_kDlhE97DvfUZ/images/logos/cursor.svg?fit=max&auto=format&n=QHH_kDlhE97DvfUZ&q=85&s=b3faa266343083f847bbdf001ce1c506

Cursor

Open Settings, go to Plugins, paste https://github.com/MigmaAI/migma-skills, then install Migma.
Browse the skill source on GitHub or install it with npx skills add MigmaAI/migma-skills --skill migma.

Configuration

API key

Set your Migma API key as an environment variable:
export MIGMA_API_KEY=your_migma_api_key
Get your API key from Settings → API Integration → API Keys.
No key yet? Your agent can register itself: it fetches https://api.migma.ai/auth.md, you approve it with a one-time code, and it receives its own scoped key. See Agent registration.

Default project

Optionally set a default project ID so you don’t have to specify it every time:
export MIGMA_PROJECT_ID=proj_abc123

Features

The official Migma skills cover two main workflows:

App setup

Use setup when an agent needs to install or wire Migma into an existing app. It audits the app’s current emails, templates, campaigns, transactional sends, lifecycle jobs, and backend triggers, then creates or reuses Migma emails and stores the resulting emailId values for safe server-side sends.

Daily Migma work

Use migma when the agent is already working in Migma: creating, editing, testing, sending, scheduling, validating, exporting, or managing contacts.

AI email generation

Generate production-ready, on-brand emails from a text prompt. The agent handles the full workflow — calling the API, waiting for generation, and returning finished HTML, screenshots, and email IDs for single emails or series.

Prompt editing

Update a generated email with natural language. The agent uses the returned emailId, asks Migma to revise that email, and returns updated HTML and screenshots. For a series, the agent picks the correct result.emails[].emailId, edits that one email, then can fetch the same emailId again to verify the saved result.

Fetch generated emails

Get any generated email by emailId to retrieve production HTML, subject, preheader, and screenshot URLs. This works for single emails and each slot in a generated series.

Instant sending

Send generated emails through Migma’s managed domains — no DNS setup required. Create a sending domain with a single command, test-send with emailId, then send to one recipient, tag, or segment. You can also connect external providers like Amazon SES or Resend.
CapabilityHow the skill handles it
Generate one emailmigma generate "..." --wait --json
Generate a seriesmigma generate "..." --count 3 --wait --json
Get generated email HTMLmigma emails get <emailId> --output ./email.html --json
Prompt-edit an emailmigma emails edit <emailId> --prompt "..." --output ./email.html --json
Send a testmigma send-test --email <emailId> --to test@example.com --json
Send selected emailmigma send --email <emailId> --to user@example.com --subject "Welcome" --from hello@brand.migma.email --from-name "Brand" --json
Send marketing campaignmigma campaigns create --name "Launch" --conversation <conversationId> --email <emailId> --from hello@brand.migma.email --from-name "Brand" --recipient-type tag --recipient-id <tagId> --json

Validation

Run preflight checks before sending: compatibility across 30+ email clients, broken link detection, AI-powered spelling and grammar, and spam score analysis.

Audience management

Create, list, update, and delete contacts. Bulk import from CSV. Organize contacts with tags and segments.

Marketing campaigns

Create named marketing campaigns from generated emails, send to a tag or segment, schedule for later, and track campaign status. For a series, the agent uses the exact emailId for the email you want to campaign.

Platform export

Export generated emails to Klaviyo, Mailchimp, HubSpot, HTML, MJML, and PDF — ready to use in your existing tools.

Brand import

Import your brand identity (colors, fonts, logos, tone of voice) from any website URL. The agent can set up a new brand in seconds.

Example usage

Once installed, ask your AI agent things like:
  • “Generate a welcome email for new subscribers”
  • “Create a three-email onboarding series and show each email ID”
  • “Make the welcome email shorter and more transactional”
  • “Send that email to sarah@example.com
  • “Generate a product launch email and send it to the Newsletter segment”
  • “Validate the email for compatibility issues”
  • “Import my brand from https://yourbrand.com
  • “Create a managed sending domain called mycompany”
  • “List all my contacts tagged VIP”
  • “Check the spam score of my email”
  • “Export my email for Klaviyo”

Resources

OpenClaw

Use Migma from WhatsApp, Telegram, Discord

MCP Server

Connect to Claude Desktop, Cursor

CLI

Migma CLI reference

SDK

Node.js SDK

API Reference

Full endpoint docs

Discord

Get help from the community