Claude Code plugin
claude-outreach runs your whole outbound from Claude Code, from the ideal customer profile to the replies, with Emelia as the engine. Install, keys, commands and updates.
claude-outreach is an open source plugin for Claude Code, MIT licensed. It packages a method: define who you target, build and clean the list, find and verify emails and phone numbers, write a sequence that does not read like a template, check deliverability, launch in Emelia, triage the replies, and read what worked.
Install
Add the plugin
In Claude Code:
/plugin marketplace add emelia-io/claude-outreach
/plugin install claude-outreach@claude-outreachFrom a terminal, the same with claude plugin marketplace add emelia-io/claude-outreach then claude plugin install claude-outreach@claude-outreach.
Add your keys
The skills call the Emelia REST API with the key in your environment. In ~/.zshrc or ~/.bashrc:
export EMELIA_API_KEY="..." # enrichment, contacts, campaigns, replies
export BASILE_API_KEY="..." # optional, French B2B dataOpen a new terminal, then start Claude Code from it: a variable exported in another terminal is not visible to it. Without a key, everything still runs in dry run: you get the list, the copy and the sequence as files, nothing is sent and nothing is charged.
Connect the MCP server (optional)
The plugin does not configure the MCP server
Installing the plugin adds skills and agents, not the MCP server. Some agents of the plugin use the Emelia MCP tools when the server is there: add it yourself, under the name emelia.
claude mcp add --transport http --scope user emelia https://mcp.emelia.io/mcp \
--header "Authorization: YOUR_EMELIA_API_KEY"Keep the name emelia: the agents look for tools named mcp__emelia__*. See MCP server.
Start
Skills of a plugin are called with the name of the plugin first:
/claude-outreach:outreach pilotA guided first campaign on 100 contacts, with a checkpoint at every step. It asks who you sell to, builds a small list, enriches it, writes the sequence with you, checks your deliverability, and launches only when you say so. Every step writes a file you keep, in an outreach/ folder.
Once you trust it:
/claude-outreach:outreach full "sell our API monitoring tool to CTOs of French SaaS companies, 20 to 200 people"Commands
Each command is /claude-outreach:outreach <command> (or /outreach <command> with a manual install).
| Command | What it does |
|---|---|
pilot | Guided first campaign on 100 contacts |
full <brief> | The complete pipeline, from targeting to analysis |
offer <url> | Turn what you sell into an offer a competitor could not copy |
icp <brief> | Turn a vague brief into a targeting spec |
leads <query> | Build the list from Basile, LinkedIn or a CSV |
filter <list> | Deduplicate, exclude customers and the blacklist, segment |
find-email <list> | Find professional email addresses |
find-phone <list> | Find phone numbers |
verify <list> | Verify the addresses you brought yourself |
enrich <list> | Find what is missing, verify only what needs it |
write <angle> | Subjects, openers, follow ups, break up |
personalize <list> | Icebreakers and AI variables per contact |
sequence <spec> | Steps, delays, conditions, A/B tests |
deliverability | SPF, DKIM, DMARC, warmup, volume, ramp plan |
campaign <spec> | Create and launch the campaign in Emelia |
replies | Triage replies, draft answers, handle opt outs |
audit <campaign> | Rates per step and variant, against benchmarks |
What it will not do
- Spend credits, launch a campaign or reach a human without your confirmation.
- Launch when your deliverability is not ready: missing SPF, DKIM or DMARC, warmup off, or a volume above what your mailboxes can carry.
- Scrape LinkedIn outside the official Emelia integration.
Stay up to date
Plugins from a third party marketplace do not update on their own. In Claude Code:
/plugin marketplace update claude-outreachor from a terminal, claude plugin update claude-outreach@claude-outreach. With a manual install from a git clone, run git pull in the clone, or bash scripts/check-update.sh to see how far behind you are.
MCP server
Connect Claude Code, Claude Desktop, Cursor, VS Code or any MCP client to your Emelia account. 26 tools for campaigns, lists, contacts, enrichment and deliverability.
Claude skill
Download the emelia-api skill, one SKILL.md that teaches Claude the Emelia API, its rules and its traps, so the code it writes works the first time.