D4umak/linkedin-outreach-mcp

HeyLead is an AI agent for LinkedIn outreach: it finds the right people, writes to them in the voice of your own LinkedIn posts, follows up, and handles replies. It runs from Claude Code, Cursor, any MCP client or a web dashboard. Sign in on the web, then talk to your AI and say "find me leads."
Use cases
A campaign has one of six goals, and the ICP, the fit check and the messages follow it: Sell a product or service, Find a job, Hire people, Find partners or investors, Find a vendor and Research interviews.
- **Sell a product or service**: Reach the people who buy what you built.
- **Find a job**: Reach the people who hire for the role you want.
- **Hire people**: Reach candidates for a role you are filling. Works with a custom brief.
- **Find partners or investors**: Reach the people who can sign a partnership or an investment. Works with a custom brief.
- **Find a vendor**: You are the buyer. Reach the people who sell what you need.
- **Research interviews**: Reach people to interview, survey or test with. Works with a custom brief.
Hire people, Find partners or investors and Research interviews run on a custom brief until their message sets exist.
---
Getting Started
MCP (Model Context Protocol) lets AI assistants use external tools. HeyLead gives your AI the ability to do LinkedIn outreach for you.
**You need:** Cursor or Claude Code — any MCP-compatible AI editor.
Step 1: Install HeyLead
**Claude Code, as a plugin (hosted, nothing to install):**
Then run /mcp, pick heylead and choose Authenticate to sign in to your
HeyLead account. The plugin connects the hosted server at
https://heylead.dev/mcp and adds skills for starting a campaign, approving
waiting messages, answering replies, a weekly review, pausing, and adding a
list of people. Its source is in
plugins/heylead.
**Or run the client locally over stdio.** You need uv:
**Claude Code:**
**Cursor:** Settings > MCP > "Add new MCP server" > Name: heylead, Command: uvx heylead
**Any MCP client:**
Update with uvx --refresh heylead.
Step 2: Set up your account
**Option A — Hosted (easiest):** take the 90-second quiz
or sign in at heylead.dev/dashboard/login.
Your quiz personas become a draft campaign. Connect LinkedIn in
Settings → Connected accounts, then launch from the dashboard — or copy your
setup message from Settings → Integrations → Chat client into your AI chat.
Nothing sends before you launch. Hosted users share a professional directory;
campaigns and inboxes stay private.
**Option B — Self-hosted:** run everything against your own accounts. You need two things first:
1. **A Unipile account** — this is what talks to LinkedIn. Sign up at
unipile.com, then put the DSN and API key from
the Access Tokens page, then run heylead config set unipile_api_url
and heylead secrets set unipile_api_key (it prompts; the key is kept in
your OS keychain, never in the config file).
2. **An LLM API key** — AI calls are billed to you. A free
Gemini key is enough to start.
Then open your AI chat and say:
> **"Set up my HeyLead profile with this Gemini key: YOUR_KEY"**
You'll get a LinkedIn authentication link. Open it, connect LinkedIn, then say
**"finish setup"**. HeyLead fetches your profile and analyses your writing style.
Step 3: Find leads
---
How It Works
1. **Define your ICP** — "Generate an ICP for AI SaaS founders" → RAG-powered personas with pain points, barriers, and LinkedIn targeting
2. **Create a campaign** — "Find me fintech CTOs" → searches LinkedIn, scores prospects by fit
3. **Warm up prospects** — Engages with their posts (comments, likes) before reaching out
4. **Send personalized invitations** — Voice-matched messages that sound like you, not a bot
5. **Follow up automatically** — Multi-touch sequences after connections are accepted
6. **Handle replies** — Detects sentiment, advances positive leads toward meetings, answers questions
7. **Track outcomes** — Won/lost/opted-out tracking with conversion analytics
**Sending model:** campaigns are created as drafts and only start when you
explicitly launch them. Every send passes rate limits, working-hours checks,