mailgo-cold-mail-marketing
AI-powered cold email campaign management through Model Context Protocol (MCP).
Documentation
mailgo-campaign-suite
Complete cold email campaign plugin for Mailgo. One plugin handles the entire outreach pipeline:
1. Verify recipient emails (async submit + poll)
2. Claim a free pre-warmed mailbox (90+ sender score, 60 days)
3. Optimize email content (spam triggers, HTML cleanup, deliverability)
4. Send campaigns (content upload, lead import, activation)
5. Manage campaign lifecycle (activate, pause, delete, list)
6. Report campaign statistics (overview, per-round, daily progress)
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-marketingPublisher
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
Requirements
- Python 3.7+
- `MAILGO_API_KEY` environment variable (OpenAPI Key from Mailgo)
- No third-party dependencies (stdlib only: `urllib`, `json`, `csv`, `ssl`)
- Optional: `openpyxl` for .xlsx file support (`pip install openpyxl`)
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_KEY` is 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 fileQuick 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 "Hi" \
--recipients "alice@example.com" \
--campaign-name "My Campaign"
# 5. Check status
python3 scripts/campaign_control.py list
python3 scripts/campaign_report.py overviewScripts 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.
Frequently asked questions
What is mailgo-cold-mail-marketing?
mailgo-cold-mail-marketing is AI-powered cold email campaign management through Model Context Protocol (MCP).
How do I install mailgo-cold-mail-marketing?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is mailgo-cold-mail-marketing open source?
Yes — it is hosted on GitHub at https://github.com/leadsnaviDeveloper/mailgo-cold-mail-marketing and has 5 stars.
Related MCP tools
cogneeCognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.
skyvernAutomate browser based workflows with AI
hindsightHindsight: Agent Memory That Learns
watermarks-removerA privacy-first app that strips AI watermarks from content you own.
Qwen-AgentAgent framework and applications built upon Qwen>=3.0, featuring Function Calling, MCP, Code Interpreter, RAG, Chrome extension, etc.
pal-mcp-serverThe power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP