HeyLead: LinkedIn Outreach & Lead Generation MCP Server

MCPAI代理

提供方 D4umak

AI代理 HTTP · 远程 OAuth 授权 社区 / 第三方 ClaudeCursorGemini CLICodex
查看接入方式

HeyLead: AI agent for LinkedIn outreach. Finds the right people, writes in your voice, follows up and handles replies, from Claude Code, Cursor, any MCP client or a web dashboard.

一句话选型结论

按资料字段整理

HeyLead: LinkedIn Outreach & Lead Generation MCP Server 属于AI代理类 MCP 服务器,HTTP · 远程,OAuth 授权,可直接接入 Claude、Cursor、Gemini CLI 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式HTTP · 远程 鉴权OAuth 授权 部署方式远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

linkedin outreach lead generation sales recruiting job search remote oauth

支持客户端

适用场景

linkedinoutreachlead generation

安装与配置

HTTP · 远程 OAuth 授权
连远程 HTTPS 端点,通常为 Streamable HTTP
https://heylead.dev/mcp

把它填进客户端的 MCP 配置即可,不需要在本地安装运行时。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Gemini CLI,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
HeyLead: LinkedIn Outreach & Lead Generation MCP Server当前 未标注 HTTP · 远程 远程部署 有 未标注
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方D4umak上游标注的维护方 D4umak
分类AI代理本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · python本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

16.8 KB
来自项目仓库与上游目录的原文,未做删改

HeyLead

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):```
/plugin marketplace add D4umak/linkedin-outreach-mcp
/plugin install heylead@heylead


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:**```bash
claude mcp add heylead -- uvx heylead

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

Any MCP client:```json
{
"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:

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```
"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

Sending 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. HeyLead sends from your own LinkedIn account at a human pace: at most 20 invitations a day and 100 a week on a free LinkedIn account (more on Premium or Sales Navigator: a newly connected paid account starts at 20 a day and doubles each week up to its limit), Monday to Friday 08:00 to 22:00 in your time zone, minutes apart. It backs off when LinkedIn pushes back and resumes on its own. You can pause any campaign at any time. Launching is also what
commissions cloud sending — in observe mode nothing is commissioned and
nothing is sent, from either machine.

Approval mode (hosted): a workspace that has not chosen otherwise holds
every opening DM and follow-up until a person approves it, and the approved
text is what is sent. Read what is waiting on the dashboard's Approvals page or
with inspect(action="waiting"); decide with prospect(action="approve_message")
or discard_message. Autopilot sends them unread and is one switch away
(Settings → Sending, or scheduler(action="approval_mode", mode="autopilot")).
Invitations, InMail and replies are never held.


Tools

HeyLead gives your AI 22 tools:

Core Workflow

Tool What it does
setup_profile Connects LinkedIn and analyzes your writing style into a voice signature
generate_icp Generates a rich Ideal Customer Profile with buyer personas
icp Previews which LinkedIn profiles a saved ICP matches, without creating a campaign
profile_signals Compiles a targeting request (country ties, interests) into LinkedIn recall queries and profile-evidence scoring
create_campaign Creates an outreach campaign (as a draft) from a natural language description
generate_and_send Generates a personalized LinkedIn message and sends it
check_replies Checks for new replies across campaigns, classifies sentiment, surfaces hot leads
book_meeting Puts an agreed call on your Google Calendar and sends the prospect an invite
show_status Your dashboard — campaigns, stats, hot leads, account health. Links to the matching heylead.dev/dashboard page and, on hosted accounts, attaches a snapshot card

Outreach & Engagement

Tool What it does
send_message Sends follow-ups and replies to prospects
send_email Sends email via a connected Unipile mailbox (Gmail/Outlook). Never Mail.app.
engage_prospect Comments on, reacts to, follows, or endorses a prospect to build trust
inbox Browses and reads LinkedIn inbox messages directly
backfill_inbox Processes unreplied inbox messages through the inbound pipeline
create_post Generates and publishes a voice-matched post to LinkedIn, or publishes your approved words with a photo or a short video

Campaign Management

Tool What it does
campaign Campaign lifecycle — launch, pause, resume, archive, delete, emergency stop, retry failed
edit_campaign Edits a campaign's name, mode, booking link, or context fields
prospect Manages prospects — skip, close with outcome, view conversation or timeline
import_prospects Imports prospects from CSV data into a campaign

Insights & Analytics

Tool What it does
analytics Campaign analytics — reports, comparisons, and exports
inspect Read-only digest of operator holds, strategist replans, closer decisions, reply skips, and gated jobs
knowledge Curates the knowledge base that grounds messages — lists, adds, removes, refreshes, and searches sources. Hosted only
suggest_next_action Recommends the best next action, prioritized by impact
signals Views and analyzes buying signals — news, company engagement, website visits, profile viewers
manage_watchlist Adds, removes, and lists signal keyword watchlists
network Network intelligence — a reciprocal pool of members' connected accounts; join to use it

Growth & Relationships

Tool What it does
brand_strategy Analyzes and improves your LinkedIn personal brand
profile Views and restores LinkedIn profile change history
partner Tracks follow-ups with business partners, vendors, and investors
contacts Searches, browses, and manages your global contact base
crm_sync Syncs campaign contacts and deals to HubSpot CRM

Automation & Account

Tool What it does
scheduler Manages the autonomous scheduler — status, on/off, send_from (cloud default / local opt-in)
product Local git checkout only — patch this repo and/or open a PR
account Manages LinkedIn accounts — list, switch, or disconnect
organization Hosted orgs — list, switch, invite editor/viewer, create a client workspace

Key Features

Voice Matching — Analyzes your LinkedIn profile and posts to capture your writing style. Every message sounds like you wrote it.

ICP Generation — RAG-powered pipeline that crawls company context, generates buyer personas with pain points, fears, barriers, and maps them to LinkedIn search parameters.

Autonomous Scheduler — Runs in the background, respects working hours and rate limits. On a hosted account, cloud is the default sender for every campaign. Launching commissions the cloud, so outreach continues with your laptop closed, inside the sending window: invitations, opening DMs, first-touch InMail, follow-ups, engagements, follows, endorsements, email fallbacks, prospect top-ups, auto-replies, inbound, warmup, signal collectors, and post-intel. This machine does not start a local scheduler engine for that work. Move the whole account here with scheduler(action='send_from', host='local'), which turns the cloud scheduler off. Observe still means nobody sends. Direct / self-hosted installs send from this machine only.

Engagement Warm-ups — Automatically engages with prospect posts before sending connection requests, building familiarity.

Pace — HeyLead sends from your own LinkedIn account at a human pace: at most 20 invitations a day and 100 a week on a free LinkedIn account (more on Premium or Sales Navigator: a newly connected paid account starts at 20 a day and doubles each week up to its limit), Monday to Friday 08:00 to 22:00 in your time zone, minutes apart. It backs off when LinkedIn pushes back and resumes on its own. You can pause any campaign at any time.

Outcome Tracking — Mark deals as won/lost, track conversion rates, identify stale leads, measure engagement ROI.


Pricing

Plan Price What you get
Free $0 Up to 2 follow-ups per prospect
Pro $29 per connected account per month Up to 5 follow-ups per prospect

A connected account is a LinkedIn seat or an email mailbox. Free includes one of either.

Invitation limits follow the LinkedIn account (free, Premium or Sales Navigator), not the HeyLead plan.
Self-hosted free installs have monthly quotas: 50 invitations, 20 messages, 30 engagements, 1 active campaign, 3 ICP generations.


Privacy

  • AI calls — routed through HeyLead's backend or your own key
  • Cloud MCP — your data is processed server-side but never shared with third parties
  • Local mode — contacts and messages stay on your machine in a local SQLite database
  • Tool-call telemetry — when you are signed in, your HeyLead workspace records each tool call: the tool, whether it worked, the error type, how long it took and the app that called it (Claude, ChatGPT, Cursor…). Never the arguments, the results, a prospect's name, a link or a message. Turn it off with heylead config telemetry off or DO_NOT_TRACK=1

> Power users: Pass your own LLM key (Gemini/Claude/OpenAI) during setup to use your own AI. Completely optional.


Where secrets are kept

HeyLead keeps its backend token, the Unipile key and any LLM keys in the OS
credential store (macOS Keychain, Windows Credential Manager, Linux Secret
Service), or in an owner-only secrets.json in the HeyLead folder when none
exists. The config file holds ordinary settings only. To inspect an install
without seeing a secret:

  • heylead config get backend_url prints one ordinary setting
  • heylead api get /api/v1/campaigns makes an authenticated read of the hosted API, credentials masked
  • heylead secrets status lists which secrets are stored, never their values
  • heylead secrets clean moves secrets out of an older config file, drops keys a cloud-sending install does not use, and deletes old config backup copies

Backend mode & env

When the MCP client talks to a HeyLead backend (e.g. heylead-api), the backend uses these environment variables. Operators running their own backend should set them as required.

Purpose Example env vars
LLM GEMINI_API_KEY, or OPENAI_API_KEY / ANTHROPIC_API_KEY if using other providers
Search / crawl SERPER_API_KEY, FIRECRAWL_API_KEY (or similar) for ICP and company context
Auth / storage GOOGLE_* (OAuth), UNIPILE_* (LinkedIn provider), plus DB/Redis if used
Optional Feature flags, rate limits, logging — see backend repo

For full backend configuration and deployment, see the heylead-api (or backend) repo and its docs.


Optional Dependencies

The base install covers all core features. For advanced ICP generation:```bash
pip install heylead[icp] # Embeddings for RAG-powered ICP generation
pip install heylead[crawl] # Web crawling for company context ingestion
pip install heylead[all] # Both


---

## Troubleshooting

**"uvx: command not found"**
Install `uv` first: `curl -LsSf https://astral.sh/uv/install.sh | sh` (or `brew install uv` on Mac)

**"MCP server not connecting"**
Restart your editor after adding the MCP server. In Cursor, check Settings > MCP — the server should show a green dot.

**"Setup failed" or "LinkedIn not connected"**
Make sure you clicked "Connect" on the LinkedIn row of the sign-in page (dashboard: Settings → Connected accounts) and completed the LinkedIn login. Then run setup again.

**Need help?** Open an issue.

---

## Publishing to PyPI (maintainers)

To make HeyLead available on PyPI (or to publish a new version):

### Option A: Publish via GitHub Release (recommended)

1. **One-time:** Create a PyPI account and an API token. In your repo: **Settings → Secrets and variables → Actions** → add secret `PYPI_TOKEN` with the token value.
2. Bump version in `pyproject.toml` (`version = "0.2.4"`).
3. Commit, push, then create a **GitHub Release** (tag e.g. `v0.2.4`, release title optional). The workflow `.github/workflows/publish.yml` runs on release and publishes to PyPI.

### Option B: Publish manually```bash
pip install build twine
python -m build          # creates dist/
twine check dist/*       # optional: validate
twine upload dist/*      # prompts for PyPI username + password (use __token__ and your API token)

After publishing, anyone can add it with claude mcp add heylead -- uvx heylead (Cursor: command uvx heylead).


For AI Agents

HeyLead is designed as an MCP-native tool — built for AI agents, not humans clicking buttons.

Install as MCP server (stdio):json { "heylead": { "command": "uvx", "args": ["heylead"] } }

OpenClaw: Add the same entry to your openclaw.json under mcp.servers.
Also available on ClawHub — search "HeyLead".

Sign in at heylead.dev (hosted), or bring your own Unipile account and LLM API key (self-hosted).

Capabilities: LinkedIn lead generation, cold outreach automation, ICP generation with buyer personas, voice-matched personalized messaging, multi-touch drip sequences, reply sentiment classification, engagement warm-ups, campaign analytics, and scheduled sending from the cloud with your laptop closed.

22 tools, from finding the right people to answering their replies: prospect discovery, ICP generation with buyer personas, connection invitations with a note, opening messages and follow-ups, warm-ups (profile views, follows, comments), reply handling that holds anything ambiguous for you, and outcome tracking.

See AGENTS.md for the full agent integration guide.


Links

  • PyPI
  • MCP Registry
  • Smithery
  • ClawHub (OpenClaw skill store)
  • Issues

License

MIT (code) — see LICENSE

Knowledge base and prompt configurations are proprietary.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
HeyLead: LinkedIn Outreach & Lead Generation MCP Server 怎么安装?

在客户端按下面的安装命令接入:https://heylead.dev/mcp。装完在客户端配置里引用同一个包或端点。

HeyLead: LinkedIn Outreach & Lead Generation MCP Server 怎么在 Claude、Cursor、Gemini CLI 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

HeyLead: LinkedIn Outreach & Lead Generation MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

HeyLead: LinkedIn Outreach & Lead Generation MCP Server 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

HeyLead: LinkedIn Outreach & Lead Generation MCP Server 支持哪些客户端?

资料标注支持 Claude、Cursor、Gemini CLI、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

HeyLead: LinkedIn Outreach & Lead Generation MCP Server 能提供哪些能力?

资料显示能力标签包括 linkedin、outreach、lead generation、sales、recruiting、job search。具体工具清单以官方文档为准。

HeyLead: LinkedIn Outreach & Lead Generation MCP Server 需要什么运行环境?

运行时为 python;属于远程端点,不需要在本地装运行时。

HeyLead: LinkedIn Outreach & Lead Generation MCP Server 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。