Heyreach
HeyReach is a multichannel outreach platform designed to help businesses and professionals engage with their audience effectively.
Verdict
Common use cases
- Audit LinkedIn campaign performance during standups
- Pull lead lists for sales pipeline reviews
- Check which LinkedIn accounts need reconnection
- Set up webhooks for real-time lead activity
- Troubleshoot stalled outreach sequences in chat
Integration
- Vendor
- Heyreach
- Category
- other
- Auth
- API_KEY
- Tools
- 16
- Composio slug
heyreach
Tools
- Check API Key
Tool to check if the api key is valid. use before making other api calls to confirm authentication.
- Create Empty List
Tool to create an empty list. use after deciding on list name and type.
- Create Webhook
Tool to create a new webhook. use when you need programmatic callbacks for heyreach events after confirming a valid api key.
- Delete Webhookdestructive
Tool to delete an existing webhook. use when you need to remove callbacks for outdated or unwanted webhooks.
- Get All Campaigns
Tool to retrieve all campaigns. use when you need a paginated list of campaigns for management or reporting.
- Get All Leads
Tool to retrieve all leads in a heyreach list. use when you need paginated collection of leads after confirming a valid api key.
- Get All LinkedIn Accounts
Tool to retrieve all linkedin accounts. use when you need a paginated list of linkedin accounts after confirming a valid api key.
- Get All Lists
Tool to retrieve all lists. use when you need a paginated list of lists after confirming a valid api key.
- Get All Webhooks
Tool to retrieve all webhooks. use when you need a paginated collection of webhooks after confirming a valid api key.
- Get Companies From List
Tool to get companies from a company list. use when you need a paginated list of companies after specifying a list id.
- Get Conversations V2
Tool to retrieve paginated linkedin conversations with advanced filters. use when you need to fetch inbox conversations filtered by lead or profile details.
- Get Lead
Tool to retrieve detailed information for a lead by profile url. use after obtaining the exact linkedin profile url to fetch full lead details.
- Get Leads From List
Tool to get a paginated list of leads from a lead list. use when you need to filter and page through leads for a specific list.
- Get My Network for Sender
Tool to get the linkedin network for a specified sender account. use when you need to retrieve paginated connections for a sender.
- Get Webhook By ID
Tool to retrieve a webhook by its id. use when you need detailed configuration of a specific webhook after listing or creating it.
- Update Webhook
Tool to update an existing webhook’s configuration. use when you need to modify a webhook's name, url, event type, campaigns, or activation status after confirming the webhookid.
Setup
Setup guide
- 11. In Switchy, open the Space where you want to use Heyreach and click the integrations panel. 2. Search for Heyreach and select 'Connect'. 3. Log into your Heyreach account, navigate to Settings > API, and copy your API key. 4. Paste the key into Switchy's auth prompt and click 'Authorize'. 5. Back in the Space, type '@Heyreach check API key' to confirm the connection works. 6. If the response shows valid authentication, you're ready to invoke other tools. 7. To fetch campaigns, type '@Heyreach get all campaigns' and the MCP will return a paginated list. 8. Use '@Heyreach get all leads' to pull leads from a specific list, or '@Heyreach get all LinkedIn accounts' to see which profiles are connected. 9. For webhook setup, use '@Heyreach create webhook' and provide the callback URL and event types you need.
What teammates see: by default, memories from Heyreach are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Campaign Health Check
@Heyreach get all campaigns and show me which ones have reply rates below 5% or haven't sent messages in the last 3 daysOpen in a Space →
Lead Export for Review
@Heyreach get all leads from the 'Q1 Enterprise Prospects' list and summarize their job titles and company sizesOpen in a Space →
Account Status Audit
@Heyreach get all LinkedIn accounts and flag any that show connection errors or have exceeded daily invite limitsOpen in a Space →
Webhook Setup for Slack
@Heyreach create a webhook pointing to our Slack incoming webhook URL that triggers on lead reply eventsOpen in a Space →
List Creation for New Campaign
@Heyreach create an empty list called 'APAC SaaS Directors' with type 'campaign' so we can start adding leadsOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@heyreach show me all my active LinkedIn accounts and their current status
Found 3 LinkedIn accounts connected to your Heyreach workspace. Account 1 (john.smith@company.com) is active with 847 connections, last activity 2 hours ago. Account 2 (sarah.jones@company.com) is active with 1,203 connections, last activity 15 minutes ago. Account 3 (mike.chen@company.com) is currently paused for rate limit cooldown, will resume in 4 hours. All accounts are within LinkedIn's daily connection request limits.
This example demonstrates read-only account monitoring. Requires a valid API key with read permissions. Heyreach enforces LinkedIn's rate limits per account — the MCP surfaces these constraints but cannot override them. Useful for daily team check-ins on outreach capacity.
@heyreach create a new list called 'Q1 Enterprise Prospects' for our ABM campaign
Created list 'Q1 Enterprise Prospects' (ID: list_8x9k2m) as an empty container. The list is now available in your Heyreach dashboard and ready to receive leads. You can populate it by importing CSV contacts, adding LinkedIn profile URLs manually, or connecting it to a campaign workflow. List type is set to 'standard' — you can convert to 'smart list' later if you need dynamic filtering rules.
This write operation creates a persistent resource in your Heyreach account. The MCP confirms creation but doesn't auto-populate the list — that's a separate import step. Be aware that list names must be unique within your workspace, and deleted lists cannot be recovered.
@heyreach pull all leads from my 'SaaS Founders' list and summarize their engagement status for our weekly review
Retrieved 127 leads from 'SaaS Founders' list. Engagement breakdown: 43 leads (34%) have accepted connection requests and received first message, 29 leads (23%) are pending connection acceptance (avg wait time 3.2 days), 38 leads (30%) have been contacted but not yet responded, 17 leads (13%) are marked as 'not interested' or unresponsive after follow-up sequence. Top performing message template: 'Founder-to-founder intro' with 41% response rate. 8 leads flagged for manual review due to LinkedIn profile changes.
This synthesis example combines lead retrieval with AI analysis of engagement patterns. The MCP provides raw lead data (status, timestamps, message history) which the AI interprets into actionable insights. Pagination applies for lists over 100 leads — this example assumes a single-page result. Engagement metrics depend on webhook data being properly configured.
Use-case deep-dives
When Heyreach MCP fits outbound prospecting at 5-10 reps
A 7-person sales team runs LinkedIn outreach campaigns and needs to pull lead status into their weekly pipeline review. The Heyreach MCP gives you direct API access to campaigns, leads, and LinkedIn account health without opening the vendor dashboard. You can script a standup report that shows which campaigns hit reply thresholds or which accounts need rotation. The webhook tools let you push lead replies into Slack or your CRM in real time. This works if your team runs 3-8 concurrent campaigns and checks status daily. If you're running 20+ campaigns or need complex lead scoring, you'll want a dedicated integration platform instead of raw MCP calls. For teams that live in Switchy and want one-off lead pulls or campaign checks, this MCP closes the loop without context-switching.
Using Heyreach MCP for account expansion research
A 4-person customer success team identifies expansion opportunities by researching decision-makers at existing accounts on LinkedIn. They use Heyreach to organize prospects into lists by account tier and job function. The MCP's list creation and lead retrieval tools let them build a Switchy workflow that pulls leads by list name, checks campaign engagement, and surfaces warm contacts for outreach. The API key check tool confirms auth before bulk operations, and the paginated lead retrieval handles lists with 200+ contacts. This scenario breaks down if your CS team doesn't already use Heyreach for LinkedIn prospecting or if your account data lives in a CRM that doesn't sync with Heyreach. For teams that do run LinkedIn research in Heyreach, the MCP turns list management into a scriptable task instead of a manual dashboard chore.
When Heyreach MCP speeds up quarterly outreach audits
A solo marketing ops manager audits LinkedIn outreach performance every quarter to decide which campaigns to pause or scale. The Heyreach MCP's campaign and lead retrieval tools let them pull all active campaigns, check lead counts per list, and compare LinkedIn account usage across the org. They script a report in Switchy that flags campaigns with low reply rates or accounts hitting connection limits. The webhook deletion tool cleans up stale callbacks from old campaigns. This works for orgs running 10-30 campaigns where manual dashboard review takes hours. If you're auditing 50+ campaigns or need attribution across multiple channels, you'll want a BI tool instead. For quarterly or monthly audits where you need a quick snapshot of Heyreach activity, the MCP gives you the data without exporting CSVs or building custom dashboards.
Frequently asked
What does the Heyreach MCP do in Switchy?
The Heyreach MCP connects your LinkedIn outreach campaigns to Switchy's AI workspace. It lets you check API authentication, retrieve campaigns and leads, manage lists, pull LinkedIn account data, and set up webhooks for event callbacks. Your team can query campaign performance, export lead lists, or automate workflows without leaving the Switchy interface.
Do I need a Heyreach API key to use this MCP?
Yes. The MCP uses API key authentication, so you'll need a valid Heyreach API key before connecting. Heyreach typically issues keys from your account settings. The MCP includes a Check API Key tool that validates your credentials before making other calls, so you'll know immediately if the key is misconfigured or expired.
Can the Heyreach MCP send LinkedIn messages or connection requests?
No. The MCP is read-only for campaigns and leads, plus it can create lists and webhooks. It won't send messages, trigger outreach sequences, or accept connection requests on your behalf. If you need to launch a campaign or modify outreach steps, do that directly in Heyreach's dashboard, then use the MCP to pull results into Switchy.
Why use the Heyreach MCP instead of logging into Heyreach directly?
The MCP surfaces campaign and lead data inside Switchy's shared workspace, so your team can ask questions like "which campaigns have the highest reply rate this month" without context-switching. You still configure sequences and LinkedIn accounts in Heyreach; the MCP just makes the data queryable alongside your other tools in one AI interface.
Who on the team should connect the Heyreach MCP?
Whoever owns your Heyreach account and has access to generate API keys. That's usually your sales ops lead or growth manager. Once connected, any Switchy workspace member can query campaigns and leads through the MCP, but only the person with the API key can update the connection or revoke access.