add-leads-to-campaignLABSCO SUMMARY
Reporting and inbox triage move to the model; the sending stays in HeyReach.
The writes are narrow and deliberate: toggle-campaign-status, create-empty-list and add-leads-to-campaign. Everything else reads — there is no tool that composes a message, edits a sequence or replies to a conversation, so this changes how you inspect an outreach programme rather than how it runs. The filters on get-conversations and get-overall-stats are the part that earns its place: an inbox narrowed by campaign, sender and seen state arrives small enough to reason about.
What it is
A HeyReach client for LinkedIn outreach: campaigns and their status, the lead lists behind them, the conversations they produced, and the stats over a date range.
What you get
- Campaigns: get-all-campaigns and get-active-campaigns page through them, get-campaign-details returns one by campaignId, and toggle-campaign-status pauses or resumes it.
- Leads and lists: get-all-lists pages the lists, create-empty-list makes one by name and type, add-leads-to-campaign pushes leads into a campaign, and get-lead-details looks a person up by profileUrl.
- Conversations: get-conversations filters an inbox by campaignIds, linkedInAccountIds, leadLinkedInId, leadProfileUrl, searchString and seen state before any of it reaches the model.
- Reporting: get-overall-stats takes accountIds, campaignIds, startDate and endDate, and get-my-network-for-sender pages a sender's own network by senderId.
- check-api-key confirms the key the server is running with before anything else is attempted.
Requirements
A HeyReach account and an API key for it, and at least one LinkedIn sender account connected in HeyReach — conversations, stats and network results are all addressed by LinkedIn account id.
Setup effort
One command plus a key — npx heyreach-mcp-server --api-key=<YOUR_HEYREACH_API_KEY>, then supply credentials
USE CASES
01
Finding out which campaign is actually producing replies
Take the running campaigns, read the stats for the window you care about, and go into the conversations behind the numbers.
02
Loading a new batch of prospects into a campaign already running
Check what lists exist, create the one this batch belongs to, and push the leads into the campaign without pausing it.
03
Pausing outreach before a week when nobody is there to answer
Find the campaign, confirm what it is set to, and toggle its status rather than letting sequences run into an empty inbox.
04
Checking who a reply came from before answering it
Look the person up by their profile URL, and check whether they are already in the sender's network before the reply is written.
12 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
check-api-keycreate-empty-listget-active-campaignsget-all-campaignsget-all-listsget-campaign-detailsget-conversationsget-lead-detailsget-my-network-for-senderget-overall-statstoggle-campaign-statusBEFORE YOU INSTALL
What to know first
Tools you get
12 tools when we connected. Get-campaign-leads, send-message, perform-social-action and get-campaign-metrics are documented but not available; messaging runs through HeyReach's campaign engine, not a tool.
Requires
- npx on PATH
- Node.js 18+
- HEYREACH_API_KEY in your environment
Where it runs
All 5 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 12 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx heyreach-mcp-server --api-key=<YOUR_HEYREACH_API_KEY>MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"heyreach": {
"command": "npx",
"args": [
"heyreach-mcp-server@2.0.0",
"--api-key=<YOUR_HEYREACH_API_KEY>"
]
}
}
}Cursor, Windsurf
JSON
{
"mcpServers": {
"heyreach": {
"command": "npx",
"args": [
"heyreach-mcp-server",
"--api-key=<YOUR_HEYREACH_API_KEY>"
]
}
}
}n8n — stdio, Any MCP client — stdio
JSON
{
"mcpServers": {
"heyreach-mcp": {
"command": "npx",
"args": [
"heyreach-mcp-server@2.0.0",
"--api-key=<YOUR_HEYREACH_API_KEY>"
],
"transport": "stdio"
}
}
}
