Heyreach MCP server

Connect Heyreach to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Heyreach MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the create list tool in Heyreach
  • Use the get linked in accounts tool in Heyreach
  • Use the get overall stats tool in Heyreach
  • Use the get conversations tool in Heyreach
  • Use the list lead lists tool in Heyreach
  • Use the get leads from list tool in Heyreach

Supported Tools

create_list

Create List

Create a new empty lead or company list in HeyReach. Lists can be used to organize leads before adding them to campaigns.

get_linkedin_accounts

Get LinkedIn Accounts

Retrieve all connected LinkedIn sender accounts in your HeyReach workspace. Returns account details including status, capacity, and availability.

get_overall_stats

Get Overall Stats

Retrieve comprehensive analytics and performance statistics across your HeyReach campaigns. Includes metrics such as total leads, contacted count, replied count, connected count, response rate, and connection rate. Supports filtering by date range, accounts, and campaigns.

get_conversations

Get Conversations

Retrieve LinkedIn conversations from your HeyReach unified inbox with advanced filtering. Returns paginated conversation data with messages.

list_lead_lists

List Lead Lists

Retrieve all lead and company lists from your HeyReach account. Lists serve as containers for organizing leads before or during campaign assignment.

get_leads_from_list

Get Leads from List

Retrieve leads from a specific HeyReach lead list with optional filtering by keyword and date range. Returns paginated lead data.

list_campaigns

List Campaigns

Retrieve LinkedIn outreach campaigns from your HeyReach account. Supports filtering by keyword, status, and LinkedIn account. Returns campaign details including name, status, and performance metrics.

send_message

Send Message

Send a direct LinkedIn message to a lead through HeyReach. Requires the conversation ID, LinkedIn sender account ID, and message text.

get_lead

Get Lead

Retrieve detailed information about a lead by their LinkedIn profile URL. Returns the lead's profile and enrichment data.

get_campaign

Get Campaign

Retrieve detailed information about a specific HeyReach campaign by its ID. Returns campaign settings, status, and performance data including response rates and connection rates.

toggle_campaign_status

Toggle Campaign Status

Pause or resume a HeyReach LinkedIn outreach campaign. Use this to control whether a campaign is actively running or paused.

add_leads_to_campaign

Add Leads to Campaign

Add leads with personalization data to an existing HeyReach campaign. Leads are specified with their LinkedIn profile URL and optional fields like name, company, position, and custom variables for sequence personalization.

add_leads_to_list

Add Leads to List

Add leads with personalization data to an existing HeyReach lead list. Useful for building lead lists before assigning them to campaigns.

delete_leads_from_list

Delete Leads from List

Remove leads from a HeyReach list by their LinkedIn profile URLs. Returns usernames that were not found in the list.

stop_lead_in_campaign

Stop Lead in Campaign

Stop further outreach to a specific lead in a HeyReach campaign.

Connect Heyreach to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Heyreach in Metorial. In your Metorial portal, enable the Heyreach MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Heyreach tools.

Run Heyreach through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Heyreach and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Heyreach tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Heyreach

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Hubspot

Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.

Discord

Send, edit, and delete messages in channels. Manage servers (guilds), channels, roles, members, invites, webhooks, threads, scheduled events, auto moderation rules, audit logs, application commands, and custom guild emojis.

Calendly

List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.

Linkedin

Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.

Technical notes for Heyreach

Manage LinkedIn outreach campaigns, leads, and messaging. Retrieve campaign details and performance analytics, add leads with personalization data to campaigns and lists, send direct messages, and monitor conversations. Control campaign status (pause/resume), manage lead and company lists, and access LinkedIn sender account information.

Frequently asked questions

Common questions about connecting Heyreach to AI agents with Metorial.

  1. How many tools does the Heyreach MCP server have?
    The Heyreach MCP server exposes 15 tools, including Create List, Get LinkedIn Accounts, Get Overall Stats. Each one is governed and traced through Metorial.
  2. Heyreach exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Heyreach MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Heyreach and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Heyreach MCP server yourself or use the hosted gateway.

Connect Heyreach to production AI agents

See how Metorial gives your team governed access to Heyreach, with tracing and security controls built in.