# Autonomous Cold Email

> SALES · OUTBOUND — Own your sending infrastructure instead of renting it. Claude Code skill + playbook for self-hosted cold email.

- **Type:** MCP server
- **Install:** `agentstack add mcp-gquthier-autonomous-cold-email`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gquthier](https://agentstack.voostack.com/s/gquthier)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [gquthier](https://github.com/gquthier)
- **Source:** https://github.com/gquthier/autonomous-cold-email

## Install

```sh
agentstack add mcp-gquthier-autonomous-cold-email
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Autonomous Cold Email

### Own your sending infrastructure instead of renting it.

Smartlead and Instantly charge you monthly for inboxes you already pay for.Bring the whole stack in-house — your mailboxes, your data, your sequences —and let an agent run it while you sleep.

Claude Code skill + playbook · SMTP/IMAP setup · lead sourcing & segmentation · warmup ramps · deliverability caps · reply classification · monitoring

---

This is a **Claude Code skill** + a complete playbook (with runnable templates) for building
an in-house cold-email / outbound system: connect your own SMTP/IMAP inboxes, source and
segment leads, write sequences, send at scale with deliverability-safe caps + warmup ramp,
auto-classify replies, and run it all autonomously with monitoring.

You don't rent a SaaS. You own the stack, the data lives in your own mailboxes, and an AI
agent operates it for you.

## What's inside

```
SKILL.md                     ← the master guide (start here)
references/                  ← deep-dives
  architecture.md  deliverability.md  engine-setup.md  lead-sourcing.md
  sequences.md     orchestration.md   monitoring.md    deployment.md
templates/
  accounts.example.json              orchestrator.config.example.json
  sequence.example.json
  scripts/  accounts.ts  tls.ts  extract-leads.py  enroll.mjs
            create-campaign.mjs  orchestrator.mjs  report.mjs
            test-connections.mjs  bootstrap-folders.mjs  cron-tick.sh  _shared.mjs
PRESENTATION.md              ← ready-to-record video script
```

## The stack

| Layer | Tech |
|-------|------|
| Engine | [outbound-tools](https://github.com/arnaudjnn/outbound-tools) (MCP server + CLI, TypeScript) |
| Transport | nodemailer (SMTP) · imapflow (IMAP) |
| State | IMAP keywords/drafts — **no database** |
| Lead segmentation | Python (`csv`, column-alias parsing) |
| Orchestration | Node scripts + cron (caps, warmup ramp, run-log) |
| Monitoring | Express dashboard + Telegram daily report |
| Reply classification | optional, Claude (Anthropic API) |

## Quickstart

1. **Infra** — buy secondary domains + inboxes, set SPF/DKIM/DMARC, warm up. → `references/deliverability.md`
2. **Engine** — clone `outbound-tools`, decouple it from the paid broker (one file). → `references/engine-setup.md`
3. **Connect** — `accounts.json` + `node test-connections.mjs` (all inboxes ✅).
4. **Leads** — `python3 extract-leads.py ./leads ./out/leads.csv` → segmented send-list. → `references/lead-sourcing.md`
5. **Sequence** — adapt `templates/sequence.example.json`. → `references/sequences.md`
6. **Go autonomous** — `enroll` → `create-campaign` → flip `active:true` → cron. → `references/orchestration.md`
7. **Monitor** — dashboard + daily Telegram report + bounce alerts. → `references/monitoring.md`
8. **Deploy** — €5/mo VPS + two cron lines. → `references/deployment.md`

## Install as a Claude Code skill

Drop this folder into your skills directory (e.g. `~/.claude/skills/outbound-strategy/`) and
ask your agent to "build my outbound infrastructure." It will follow `SKILL.md` step by step.

## Responsible use

Cold email is regulated (CAN-SPAM, GDPR, etc.). Only email people you may lawfully contact,
always offer an opt-out, honor it instantly, and follow the laws of your and your
recipients' jurisdictions. This project is for legitimate B2B outreach — not spam.

## Credits & license

Engine: the open-source [outbound-tools](https://github.com/arnaudjnn/outbound-tools) MCP
server. This skill adds the decoupling, lead segmentation, autonomous orchestration,
monitoring, and deployment layers. Not affiliated with Smartlead, Instantly, Lemlist, or
Apollo. MIT licensed — see `LICENSE`.

---

### Building something that runs itself?

**[bizos.cc](https://bizos.cc)** — build autonomous companies.

Built by Gauthier Thiry

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [gquthier](https://github.com/gquthier)
- **Source:** [gquthier/autonomous-cold-email](https://github.com/gquthier/autonomous-cold-email)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-gquthier-autonomous-cold-email
- Seller: https://agentstack.voostack.com/s/gquthier
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.