HeyLead — AI agent for LinkedIn outreach MCP server

<!-- mcp-name: io.github.D4umak/heylead -->

HeyLead

Your AI sales rep. One command to fill your pipeline.

HeyLead is an MCP-native autonomous LinkedIn SDR that runs inside Cursor, Claude Code, or any MCP-compatible editor. Sign in on the web, then talk to your AI and say "find me leads."

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

HeyLead runs locally over stdio. You need uv:

Claude Code:

claude mcp add heylead -- uvx heylead

Cursor: Settings > MCP > "Add new MCP server" > Name: heylead, Command: uvx heylead

Any MCP client:

{
  "heylead": {
    "command": "uvx",
    "args": ["heylead"]
  }
}

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:

unipile.com, then put the DSN and API key from the Access Tokens page into ~/.heylead/config.json as unipileapiurl and unipileapikey.

1. A Unipile account — this is what talks to LinkedIn. Sign up at

Gemini key is enough to start.

1. An LLM API key — AI calls are billed to you. A free

Then open your AI chat and say:

"Set up my HeyLead profile with this Gemini key: YOURKEY"**

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

"Find me CTOs at fintech startups in New York"
"Send outreach to the campaign"
"Check my replies"
"How's my outreach doing?"

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

Safety model: campaigns are created as drafts and only start when you explicitly launch them. Every send passes rate limits, working-hours checks, and a 1st-degree connection guard before it goes out. Launching is also what commissions 24/7 cloud sending — in observe mode nothing is commissioned and nothing is sent, from either machine.

Tools

HeyLead gives your AI 35 tools:

Core Workflow

Shortened. The full README is on GitHub.