Marketing & SocialMCP Registrypypi35 toolsA · 83

HeyLead — AI agent for LinkedIn outreach MCP server

Name: HeyLead — AI agent for LinkedIn outreach
Author: D4umak

io.github.D4umak · Updated today

AI agent for LinkedIn outreach: finds the right people, writes in your voice, follows up, replies.

At a glance

HeyLead — AI agent for LinkedIn outreach is an MCP server in the Marketing & Social category. It runs locally over stdio via `uvx heylead`, and declares no required credentials. It exposes 35 tools, including setup_profile, generate_icp and icp. It scores A (83/100) on the MCP Skills Hub health score as of Oct 27, 2026.

Source 12

One-click install

VS Code VS Code Insiders Cursor

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install HeyLead — AI agent for LinkedIn outreach in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install HeyLead — AI agent for LinkedIn outreach in Claude CodeAnthropic's agentic CLI

1
Add the server
bash
```
claude mcp add heylead -- uvx heylead
```
2
Verify it's connected
bash
```
claude mcp list
```
Sharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. setup_profile, generate_icp, icp). It discovers them automatically.

How to install HeyLead — AI agent for LinkedIn outreach in Claude DesktopDesktop app (MCP config)

Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this server

json

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

Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.

How to install HeyLead — AI agent for LinkedIn outreach in CursorAI-first code editor

Create / edit .cursor/mcp.json in your project

json

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

Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

How to install HeyLead — AI agent for LinkedIn outreach in Codex CLIOpenAI coding agent

Add to ~/.codex/config.toml

toml

[mcp_servers.heylead]
command = "uvx"
args = ["heylead"]

Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

How to install HeyLead — AI agent for LinkedIn outreach in WindsurfCodeium's agentic IDE

Edit ~/.codeium/windsurf/mcp_config.json

json

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

Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

How to install HeyLead — AI agent for LinkedIn outreach in ClineVS Code autonomous agent

Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.

Add the server

json

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

How to install HeyLead — AI agent for LinkedIn outreach in VS CodeCopilot / MCP support

Create .vscode/mcp.json

json

{
  "servers": {
    "heylead": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "heylead"
      ]
    }
  }
}

Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

What tools does HeyLead — AI agent for LinkedIn outreach expose? (35)

Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.

setup_profileConnects LinkedIn and analyzes your writing style into a voice signature
generate_icpGenerates a rich Ideal Customer Profile with buyer personas
icpPreviews which LinkedIn profiles a saved ICP matches, without creating a campaign
profile_signalsCompiles a targeting request (country ties, interests) into LinkedIn recall queries and profile-evidence scoring
create_campaignCreates an outreach campaign (as a draft) from a natural language description
generate_and_sendGenerates a personalized LinkedIn message and sends it
check_repliesChecks for new replies across campaigns, classifies sentiment, surfaces hot leads
book_meetingPuts an agreed call on your Google Calendar and sends the prospect an invite
show_statusYour dashboard — campaigns, stats, hot leads, account health. Links to the matching heylead.dev/dashboard page and, on hosted accounts, attaches a snapshot card
send_messageSends follow-ups and replies to prospects
send_emailSends email via a connected Unipile mailbox (Gmail/Outlook). Never Mail.app.
engage_prospectComments on, reacts to, follows, or endorses a prospect to build trust
inboxBrowses and reads LinkedIn inbox messages directly
backfill_inboxProcesses unreplied inbox messages through the inbound pipeline
create_postGenerates and publishes a voice-matched post to LinkedIn, or publishes your approved words with a photo or a short video
campaignCampaign lifecycle — launch, pause, resume, archive, delete, emergency stop, retry failed
edit_campaignEdits a campaign's name, mode, booking link, or context fields
prospectManages prospects — skip, close with outcome, view conversation or timeline
import_prospectsImports prospects from CSV data into a campaign
analyticsCampaign analytics — reports, comparisons, and exports
inspectRead-only digest of operator holds, strategist replans, closer decisions, reply skips, and gated jobs
knowledgeCurates the knowledge base that grounds messages — lists, adds, removes, refreshes, and searches sources. Hosted only
suggest_next_actionRecommends the best next action, prioritized by impact
signalsViews and analyzes buying signals — news, company engagement, website visits, profile viewers
manage_watchlistAdds, removes, and lists signal keyword watchlists
networkNetwork intelligence — a reciprocal pool of members' connected accounts; join to use it
brand_strategyAnalyzes and improves your LinkedIn personal brand
profileViews and restores LinkedIn profile change history
partnerTracks follow-ups with business partners, vendors, and investors
contactsSearches, browses, and manages your global contact base
crm_syncSyncs campaign contacts and deals to HubSpot CRM
schedulerManages the autonomous scheduler — status, on/off, send_from (cloud default / local opt-in)
productLocal git checkout only — patch this repo and/or open a PR
accountManages LinkedIn accounts — list, switch, or disconnect
organizationHosted orgs — list, switch, invite editor/viewer, create a client workspace

What the code can do

Source analysis currently covers npm packages only. This server ships as a Python package, which needs a different parser.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
Downloads at launch — The package is fetched from its registry each run unless you pin a version.

Last commit today — Actively maintained.
Repository created 1 month ago — Very new project with little track record yet.
12 GitHub stars — Community adoption signal.

Client compatibility

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

A · 83

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

Maintenance30%100%
Last commit 0 days ago.
Adoption20%34%
12 stars.
Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
Provenance15%75%
Links to its own repository; package linkage unverified.
Packaging15%100%
Publishes a pinned version (0.10.481).

Documentation

Full README

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):

text

/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.

Excerpt — the full document is on GitHub.

Alternatives to HeyLead — AI agent for LinkedIn outreach

Maintain HeyLead — AI agent for LinkedIn outreach? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown

[![HeyLead — AI agent for LinkedIn outreach on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/io-github-d4umak-heylead)](https://mcp-skills-hub.vercel.app/mcps/io-github-d4umak-heylead)

Catalog data refreshed Oct 27, 2026. Something wrong? Report it.