
Mailgo Cold Mail Marketing
โ 5from leadsnaviDeveloper
AI-powered cold email campaign management through Model Context Protocol (MCP).
mailgo-campaign-suite
Complete cold email campaign plugin for Mailgo. One plugin handles the entire outreach pipeline:
- Verify recipient emails (async submit + poll)
- Claim a free pre-warmed mailbox (90+ sender score, 60 days)
- Optimize email content (spam triggers, HTML cleanup, deliverability)
- Send campaigns (content upload, lead import, activation)
- Manage campaign lifecycle (activate, pause, delete, list)
- Report campaign statistics (overview, per-round, daily progress)
Publisher
This plugin is published by LeadsNavi, the company behind the Mailgo cold email platform.
- Product: https://app.mailgo.ai
- Publisher website: https://www.leadsnavi.com
Security & Credentials
This skill requires a Mailgo OpenAPI Key (MAILGO_API_KEY) to operate. Please read before using:
| Concern | Detail |
|---|---|
| What the token can do | Claim mailboxes, create/activate/pause/delete campaigns, verify emails, read campaign reports โ all actions on your Mailgo account. |
| How to obtain it | Log in to https://app.mailgo.ai โ Click your avatar in the bottom-left corner โ Personal Tokens โ Create Token โ Copy the token. See SKILL.md Step 0 for step-by-step instructions. |
| How it is used | Sent as X-API-Key: {token} header to api.leadsnavi.com โ the official Mailgo backend (LeadsNavi is the parent brand behind Mailgo; see app.mailgo.ai and the Mailgo website for details). |
| How to stay safe | Set as a local environment variable only โ never paste into chat. |
| How to revoke | Go to https://app.mailgo.ai โ Personal Tokens โ Delete the token. |
| API endpoints called | All calls go to https://api.leadsnavi.com (Mailgo's official API) โ email verification, mailbox claiming, campaign CRUD, and reporting. Review the bundled Python scripts for exact endpoints. |
MAILGO_API_KEYis your Mailgo account credential. Keep it secure and never share it publicly.
Compliance
This skill sends emails to recipient lists you provide. You are responsible for ensuring your campaigns comply with applicable laws and platform terms, including:
- CAN-SPAM Act (US) โ include a physical address and honor opt-out requests
- GDPR (EU) โ ensure you have a lawful basis for contacting recipients
- Mailgo Terms of Service โ https://app.mailgo.ai
The skill's built-in email optimizer adds a soft opt-out line to every email by default.
Directory Structure
mailgo-cold-mail-marketing/
โโโ .claude-plugin/ # Claude Code plugin
โ โโโ plugin.json
โ โโโ marketplace.json
โโโ .cursor-plugin/ # Cursor IDE plugin
โ โโโ plugin.json
โโโ .codex/ # GitHub Codex support
โ โโโ INSTALL.md
โโโ .opencode/ # OpenCode support
โ โโโ INSTALL.md
โโโ skills/
โ โโโ mailgo-campaign-suite/
โ โโโ SKILL.md # Main skill instructions
โโโ scripts/
โ โโโ verify_emails.py # Step 1: Email verification
โ โโโ claim_free_mailbox.py # Step 2: Free mailbox claiming
โ โโโ run_campaign.py # Step 4: Campaign creation & activation
โ โโโ campaign_control.py # Step 5: Lifecycle management
โ โโโ campaign_report.py # Step 6: Statistics & reporting
โโโ resources/
โ โโโ spam-triggers.md # Step 3: Spam trigger replacement table
โ โโโ industry-templates.md # Step 3: Industry-specific email templates
โโโ gemini-extension.json # Gemini CLI extension
โโโ GEMINI.md # Gemini context pointer
โโโ package.json # Package metadata (OpenCode entry)
โโโ README.md # This fileScripts Reference
| Script | Purpose | Key Args |
|---|---|---|
verify_emails.py | Submit + poll email verification | emails..., --file, --email-column |
claim_free_mailbox.py | Claim pre-warmed mailbox | --json, --api-key |
run_campaign.py | Full campaign creation flow | --sender, --subject, --body/--body-file, --recipients/--recipients-file |
campaign_control.py | Activate/pause/delete/list | activate/pause/delete/list/info |
campaign_report.py | View campaign statistics | overview/rounds/daily, --json |
Relationship to Other Mailgo Skills
This suite consolidates functionality from:
mailgo-auth-setupโ authentication guidance (Step 0)mailgo-email-verifierโ email verification (Step 1)mailgo-email-optimizerโ content optimization rules (Step 3)mailgo-campaignโ campaign creation (Step 4)mailgo-campaign-controlโ lifecycle management (Step 5)mailgo-campaign-reportโ statistics (Step 6)
Those individual skills remain available for standalone use. This suite provides the same capabilities in a single, self-contained package.
Installation (Claude Plugin)
# Add the marketplace
/plugin marketplace add leadsnaviDeveloper/mailgo-cold-mail-marketing
# Install the plugin
/plugin install mailgo-campaign-suite@mailgo-pluginsAfter installation, set your Mailgo API key as an environment variable (see Security & Credentials below), then just ask Claude to help you send cold emails.
Installation (Cursor)
/add-plugin leadsnaviDeveloper/mailgo-cold-mail-marketingSee .cursor-plugin/plugin.json for details.
Installation (Codex)
git clone https://github.com/leadsnaviDeveloper/mailgo-cold-mail-marketing.git ~/.codex/mailgo-campaign-suite
mkdir -p ~/.agents/skills
ln -s ~/.codex/mailgo-campaign-suite/skills ~/.agents/skills/mailgo-campaign-suiteSee .codex/INSTALL.md for full instructions.
Installation (OpenCode)
Add to your opencode.json:
{
"plugin": ["mailgo-campaign-suite@git+https://github.com/leadsnaviDeveloper/mailgo-cold-mail-marketing.git"]
}See .opencode/INSTALL.md for full instructions.
Installation (Gemini CLI)
gemini extensions install https://github.com/leadsnaviDeveloper/mailgo-cold-mail-marketingRequirements
- Python 3.7+
MAILGO_API_KEYenvironment variable (OpenAPI Key from Mailgo)- No third-party dependencies (stdlib only:
urllib,json,csv,ssl) - Optional:
openpyxlfor .xlsx file support (pip install openpyxl)
Quick Start
# 1. Set up authentication
export MAILGO_API_KEY="your-api-key"
# 2. Verify emails
python3 scripts/verify_emails.py alice@example.com bob@gmail.com
# 3. Claim free mailbox
python3 scripts/claim_free_mailbox.py
# 4. Create and send campaign
python3 scripts/run_campaign.py \
--sender "claimed@mailbox.com" \
--subject "Quick question" \
--body "<html><body><p>Hi</p></body></html>" \
--recipients "alice@example.com" \
--campaign-name "My Campaign"
# 5. Check status
python3 scripts/campaign_control.py list
python3 scripts/campaign_report.py overview <campaignId>No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.