# HeyReach MCP connector

Connect HeyReach to Elaichi and Claude, ChatGPT, Cursor, Microsoft Copilot, and the Elaichi Agent can list campaigns, start, pause, and resume them, add leads, and check LinkedIn account status, each person signed in as themselves.

Source: https://elaichi.ai/connectors/heyreach/

## Facts

| | |
| --- | --- |
| Application | HeyReach |
| Category | Sales Enablement |
| AI tools | 69 |
| Authentication | Connects with an API key |
| Bring your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, Microsoft Copilot, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. Connected tools are never listed one by one, however few there are. The endpoint advertises `search_tools` and `execute_tool` instead |

## What you can ask once HeyReach is connected

- Which HeyReach campaigns are paused right now?
- Add these five leads to the Q3 founders campaign.
- Which LinkedIn accounts need attention before Monday's launch?

## Connect HeyReach in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick HeyReach.
2. Optionally set Share with, then press Connect.
3. Paste a HeyReach API key. One person generates a token in HeyReach and pastes it once. Everyone else works through Share with, and never sees it.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which HeyReach tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## HeyReach MCP connector for Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## HeyReach MCP connector for Claude Code

Endpoint: https://api.elaichi.ai/mcp

1. In a terminal, run `claude mcp add` with the endpoint.
2. Start Claude Code and run `/mcp`.
3. Pick elaichi, then sign in and approve in the browser.

```bash
claude mcp add --transport http elaichi --scope user https://api.elaichi.ai/mcp
```

Use `--scope project` instead to share it with the repository through `.mcp.json`.

## HeyReach MCP connector for ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web. The plugin directory lives at chatgpt.com/plugins.

## HeyReach MCP connector for Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## HeyReach MCP connector for Microsoft Copilot

Endpoint: https://api.elaichi.ai/mcp

1. In Copilot Studio, open your agent, then Tools, Add a tool, New tool and Model Context Protocol.
2. Paste the endpoint into Server URL, choose OAuth 2.0, then Dynamic discovery, and press Create.
3. Create a new connection, sign in and approve, then press Add to agent.
4. Under Channels, open Teams and Microsoft Copilot and make the agent available in Microsoft Copilot.

Microsoft Copilot was called Microsoft 365 Copilot. Keep the tool on end-user credentials, so each person signs in as themselves.

## Connect HeyReach to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Every scope the client asks for starts ticked except "Delete things", which you tick yourself. Calling a HeyReach tool needs "Use your connected apps". Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Think hard before granting Use your connected apps, which can also delete in connected apps and cannot be undone.

## What teams do with HeyReach through Elaichi

### Add new leads to a campaign

Sales. Paste a list of prospects from a call or a trade show and have them added to the right HeyReach campaign, with the sequence and schedule already in place.

### Pause outreach when a prospect replies

SDR. Ask the agent to stop a lead in a campaign the moment they book a meeting, so nobody gets a follow-up message after they have already said yes.

### Check which campaigns are running today

Sales leadership. Get a plain answer on which HeyReach campaigns are active, paused, or waiting to start, without opening the dashboard.

### Spin up a campaign from a template

Marketing. Create a new HeyReach campaign from an approved template, update the sequence wording, and set the sending schedule in one conversation.

### Keep LinkedIn accounts healthy and assigned

RevOps. Check the status of every connected LinkedIn account, see which campaigns each one is attached to, and move accounts between campaigns when someone is out.

### Resume a client campaign after review

Agency. When a client signs off on new messaging, update the campaign settings and resume it, with the change recorded against your name.

## Elaichi vs Zapier MCP vs Composio for HeyReach

All three can connect HeyReach to an AI assistant, and all three have admin controls. They differ in where access lives and how you pay.

| What to check | Elaichi | Zapier MCP | Composio |
| --- | --- | --- | --- |
| Where the AI connects | One address for the whole organization. Endpoint: https://api.elaichi.ai/mcp | A server per member, created at sign-in. | An MCP endpoint per team, or an SDK. |
| Control over HeyReach tools | Allow or restrict single HeyReach tools, per role or user. | App and action restrictions on the account. | Role permissions, down to the action. |
| Record of calls | One audit entry per HeyReach call. | A History tab of tool calls. | A log of every tool call. |
| Single sign-on | SAML or OIDC, plus SCIM, on Gold. | SAML on Enterprise. | SAML and OIDC on Enterprise. |
| Price | Free for one person; $15 per user per month on Gold. | 2 tasks per successful call. | Billed per tool call. |

Sources: Zapier MCP [docs](https://docs.zapier.com/mcp/get-started/quickstart), [security](https://docs.zapier.com/mcp/manage/security), [usage](https://docs.zapier.com/mcp/features/usage); Composio [docs](https://docs.composio.dev/docs/composio-connect), [gateway](https://composio.dev/mcp-gateway), [enterprise](https://composio.dev/enterprise), [pricing](https://composio.dev/pricing). Checked September 2026.

Longer take: [Zapier MCP alternative](/blog/zapier-mcp-alternative/) and [when you don't need an MCP gateway](/blog/when-you-dont-need-an-mcp-gateway/).

## Frequently asked questions

### How do I connect HeyReach to Claude?

Open Elaichi, choose HeyReach, and paste your HeyReach API key when asked. There is no OAuth application to register and no client ID or secret to generate. Then in Claude go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp as the endpoint.

### Does HeyReach work with ChatGPT and Cursor as well as Claude?

Yes. Once HeyReach is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, Microsoft Copilot, any other MCP client, and the Elaichi Agent. You connect HeyReach once and every client picks it up.

### What can an AI agent actually do with my HeyReach data?

It can list your HeyReach campaigns, tell you which are running or paused, start, pause, or resume them, and change a campaign's sequence, settings, or schedule. It can add leads to a campaign, stop a lead who has replied, and check which LinkedIn accounts are connected and whether they are healthy. Short, concrete asks work better than long paragraphs.

### Does connecting HeyReach give the AI everything in my workspace?

An agent working through HeyReach only sees what the person who signed in to Elaichi can see, and the HeyReach API key behind the connection sets the outer limit. Elaichi can narrow that access with roles and restrictions, and it never widens it. If you cannot delete a LinkedIn account in HeyReach today, an agent cannot do it for you.

### Can my team share one HeyReach connection?

Yes. One person connects HeyReach in Elaichi and shares the connection with a team, and nobody else ever handles the API key. Each teammate still signs in to Elaichi as themselves, so the audit log names the person who added a lead or paused a campaign, not a shared account.

### Can I stop an agent from deleting or changing things in HeyReach?

Yes. Restrictions in Elaichi work per action, so you can allow reading HeyReach campaigns while restricting deleting LinkedIn accounts or changing a sequence, on a role or on one person. A restricted action still appears in Elaichi's tool search, flagged as restricted, but no client can run it, whatever the prompt says.

### What happens to a HeyReach connection when someone leaves?

Offboarding a person in Elaichi ends their access to HeyReach at once, across every client they used. A HeyReach connection shared with a team keeps working for everyone else. If you disconnect HeyReach in Elaichi, it is removed from Claude, ChatGPT, Cursor, Microsoft Copilot, and every other client in one step.

### Does the HeyReach MCP connector work with Gemini, Codex, Claude Code or other MCP clients?

Yes. HeyReach is reached over the same MCP endpoint every client uses, so anything that speaks MCP can call it — Gemini, Codex, Claude Code, Windsurf, Cline, Zed and OpenCode among them — alongside Claude, ChatGPT, Cursor, Microsoft Copilot, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs.

### Is Elaichi an alternative to Zapier MCP for HeyReach?

Yes. Both let Claude, ChatGPT or Cursor use HeyReach. Zapier MCP fits a team that already automates in Zapier, since each person signs in and acts as themselves in that account. Elaichi fits when IT wants one address for the whole company, per-tool rules by role, and a record of every HeyReach call.

### How is Elaichi different from Composio for HeyReach?

Composio gives AI agents tools and sign-in handling across 1,000+ apps, for developers building agents or people using an assistant, billed per tool call. Elaichi gives a company's own people governed access to HeyReach: one address, restrictions per role or user, and $15 per user per month. Both have role permissions and a log of every call.

## All 69 HeyReach tools

Every tool below is callable through https://api.elaichi.ai/mcp once HeyReach is connected, subject to the toolbox it is in and the restrictions on the caller.

- **List all HeyReach campaigns** (List). List HeyReach campaigns with optional keyword, status, and account filters. Returns: id, name, creationTime, linkedInUserListName, linkedInUserListId, campaignAccountIds, status, progressStats, excludeAlreadyMessagedGlobal, excludeAlreadyMessagedCampaignAccounts, excludeFirstConnectionCampaignAccounts, excludeFirstConnectionGlobal, and 2 more.
- **Get single HeyReach campaign by ID** (Get). Get a single HeyReach campaign by id. Returns: id, name, creationTime, linkedInUserListName, linkedInUserListId, campaignAccountIds, status, progressStats, excludeInOtherCampaigns, excludeHasOtherAccConversations, excludeContactedFromSenderInOtherCampaign, excludeListId, organizationUnitId. Required: campaignId.
- **Create a HeyReach campaign** (Create). Create a new HeyReach campaign in DRAFT status. Returns: campaignId. A sequence must be included or added via UpdateSequence before calling StartCampaign to activate the campaign.
- **HeyReach campaigns start** (Start). Activate a HeyReach campaign by campaign_id. The campaign must have a valid sequence and at least one connected LinkedIn sender account. Returns an empty 200 response on success. Required: campaign_id.
- **HeyReach campaigns pause** (Pause). Pause a HeyReach campaign by campaign_id. Returns: totalCount, items.
- **HeyReach campaigns resume** (Resume). Resume a paused HeyReach campaign. Returns an empty 200 response on success. Required: campaign_id.
- **HeyReach campaigns update settings** (Update). Update the name, lead list, and exclusion options of a HeyReach campaign (DRAFT, SCHEDULED, or PAUSED only). This is a full replacement — omitted exclusion fields reset to their defaults. Returns a 200 Success response on success.
- **HeyReach campaigns update sequence** (Update). Create or fully replace the workflow sequence of a HeyReach campaign (DRAFT, SCHEDULED, or PAUSED only). Every path through the node tree must terminate with an END node. Returns a 200 Success response on success.
- **HeyReach campaigns update accounts** (Update). Replace all LinkedIn sender accounts assigned to a HeyReach campaign (DRAFT, SCHEDULED, or PAUSED only). Full replacement — accounts not in the new list are removed. Returns a 200 Success response on success.
- **HeyReach campaigns update schedule** (Update). Replace the schedule of a HeyReach campaign, defining active hours, timezone, and enabled days (DRAFT, SCHEDULED, or PAUSED only). Returns a 200 Success response on success.
- **HeyReach campaigns create from template** (Create). Create a new HeyReach campaign by cloning an existing campaign's sequence and schedule (DRAFT status). Returns: campaignId.
- **HeyReach campaigns get sequence** (Get). Get the current sequence (workflow) of a HeyReach campaign as a linked node tree. Returns: nodeType, actionDelay, actionDelayUnit, payload, conditionalNode, unconditionalNode. Required: campaign_id.
- **HeyReach campaigns add linkedin accounts** (Add). Add LinkedIn accounts as senders to an existing HeyReach campaign. Up to 100 accounts per request; individual account failures do not fail the whole request. Returns: id, success, errorStatus.
- **HeyReach campaigns remove linkedin accounts** (Delete). Remove LinkedIn accounts from a HeyReach campaign. Up to 100 accounts per request; individual account failures do not fail the whole request. Returns: id, status.
- **List all HeyReach auth** (List). Check whether the HeyReach API key is valid and working. Returns an empty 200 response on success, or 401 Unauthorized if the key is invalid. No parameters are required.
- **List all HeyReach campaign leads** (List). List leads in a HeyReach campaign (Lead Analytics view). Returns each lead's id, linkedInUserProfile (firstName, lastName, profileUrl, linkedin_id), leadCampaignStatus, leadConnectionStatus, leadMessageStatus, creationTime, and linkedInSenderFullName.
- **Create a HeyReach campaign lead** (Create). Add leads to a HeyReach campaign, up to 100 per request. Returns: addedLeadsCount, updatedLeadsCount, failedLeadsCount.
- **HeyReach campaign leads stop** (Stop). Stop the progression of a lead in a HeyReach campaign. Returns a 200 response on success. Supply either leadMemberId (the linkedin_id from the list response) or leadUrl to identify the lead.
- **HeyReach campaign leads bulk update** (Update). Update (upsert) custom fields on a lead in a HeyReach campaign. Existing fields are updated, missing fields are created, and fields set to null or empty string are deleted. Returns the final state of all custom fields on the lead including leadId, listId, and customFields. Required: campaign_id.
- **List all HeyReach lead campaigns** (List). List all campaigns that include a specified lead in HeyReach, identified by email, LinkedIn ID, or profile URL. Returns: campaignId, campaignName, campaignStatus, creationTime, leadStatus. Supply at least one of email, linkedinId, or profileUrl to identify the lead.
- **List all HeyReach linkedin accounts** (List). List all LinkedIn accounts in HeyReach (up to 100 per request). Returns: id, emailAddress, firstName, lastName, isActive, activeCampaigns, authIsValid, isValidNavigator, isValidRecruiter, profileUrl, searchCooldown, connectionRequestCooldown, connectionNoteCooldown, inMailCooldown, accountLimits.
- **Get single HeyReach linkedin account by ID** (Get). Get a single LinkedIn account in HeyReach by id. Returns: id, emailAddress, firstName, lastName, isActive, activeCampaigns, authIsValid, isValidNavigator, isValidRecruiter, profileUrl, searchCooldown, connectionRequestCooldown, connectionNoteCooldown, inMailCooldown, accountLimits. Required: accountId.
- **Delete a HeyReach linkedin account by ID** (Delete). Remove a LinkedIn account from HeyReach by id. Optionally pass force=true to first remove the account from all active campaigns before deletion. Returns an empty 200 response on success. Required: id.
- **HeyReach linkedin accounts get status** (Get). Get the current connection status of a LinkedIn account in HeyReach. Returns: accountId, status, failureReason, profile, salesNavigator, recruiter. Required: account_id.
- **HeyReach linkedin accounts get proxy** (Get). Get the proxy configuration assigned to a LinkedIn account in HeyReach. Returns full connection details for custom proxies, or only the country code for platform-managed proxies. Returns: isCustomProxy, countryCode, host, port, username, password. Required: account_id.
- **HeyReach linkedin accounts reconnect** (Action). Reconnect a LinkedIn account in HeyReach using its stored credentials. The operation triggers immediately and processes asynchronously; poll the account status endpoint to track completion. Returns an empty 200 response on success.
- **HeyReach linkedin accounts resync** (Action). Resync the profile of a LinkedIn account in HeyReach. The operation triggers immediately and processes asynchronously; poll the account status endpoint to track completion. Returns an empty 200 response on success.
- **HeyReach linkedin accounts submit pin** (Action). Submit a verification PIN for a LinkedIn account that is awaiting PIN verification in HeyReach. Returns an empty 200 response on success; returns 409 if the account is not in a PIN-awaiting state.
- **HeyReach linkedin accounts update proxy** (Update). Update the proxy assigned to a LinkedIn account in HeyReach. Provide either proxyCountryCode for a platform-managed proxy or customProxy for your own — supplying both or neither returns 400. Returns an empty 200 response on success.
- **HeyReach linkedin accounts update inbox configuration** (Update). Update the inbox scrape configuration for a LinkedIn account in HeyReach, controlling how far back messages are synced when the account connects. Returns an empty 200 response on success.
- **HeyReach linkedin accounts relogin sales navigator** (Action). Re-authenticate the Sales Navigator session for a connected HeyReach LinkedIn account. The account must be connected and have an active Sales Navigator subscription. Returns an empty 200 response on success.
- **HeyReach linkedin accounts relogin recruiter** (Action). Re-authenticate the Recruiter session for a connected HeyReach LinkedIn account. The account must be connected and have an active LinkedIn Recruiter subscription. Returns an empty 200 response on success.
- **List all HeyReach proxy countries** (List). List all proxy country codes supported by HeyReach for use when connecting a LinkedIn account. The response structure is not enumerated in the upstream API spec; consult the HeyReach API documentation for the full payload shape. No required parameters.
- **List all HeyReach lists** (List). List all heyreach lead and company lists. Returns: id, name, totalItemsCount, listType, creationTime, campaignIds. Max 100 lists per request. Optionally filter by keyword, listType, or campaignIds.
- **Get single HeyReach list by ID** (Get). Get a single heyreach lead or company list by id. Returns: id, name, totalItemsCount, listType, creationTime, campaignIds. Required: listId.
- **Create a HeyReach list** (Create). Create an empty heyreach lead or company list. Returns: id, name, count, listType, creationTime, isDeleted, campaigns, search, status. Defaults to a USER_LIST (lead list) if type is omitted.
- **List all HeyReach list leads** (List). List leads from a HeyReach list with optional filters. Returns: profileUrl, firstName, lastName, headline, imageUrl, location, companyName, companyUrl, position, about, connections, followers, tags, emailAddress, customFields.
- **Create a HeyReach list lead** (Create). Add one or more leads to a HeyReach list. Returns: addedLeadsCount, updatedLeadsCount, failedLeadsCount.
- **HeyReach list leads delete by URL** (Delete). Delete leads from a HeyReach list by their LinkedIn profile URLs. Returns: notFoundInList.
- **HeyReach list leads bulk delete** (Delete). Delete multiple leads from a HeyReach list by their LinkedIn member IDs. Returns an empty 204 response on success. Required: listId, leadMemberIds.
- **HeyReach list leads bulk update** (List). Update custom fields for a lead in a HeyReach list. Returns: leadId, listId, customFields. Required: list_id.
- **List all HeyReach list companies** (List). List companies from a HeyReach company list. Returns: name, description, industry, imageUrl, companySize, employeesOnLinkedIn, location, specialities, website. Optionally filter by keyword. Returns up to 1000 companies per request.
- **List all HeyReach lead lists** (List). List HeyReach lead lists associated with a specific lead. Returns: listId, listName. Provide at least one of email, linkedinId, or profileUrl to identify the lead whose list memberships you want to retrieve.
- **List all HeyReach conversations** (List). List LinkedIn conversations in HeyReach using cursor-based pagination (up to 100 per page). Returns conversation items including id, read, lastMessageAt, lastMessageText, lastMessageSender, totalMessages, and 3 more fields. Optionally filter by date range, campaign, account, tags, lead, or seen status.
- **Get single HeyReach conversation by ID** (Get). Get a single HeyReach LinkedIn conversation (chatroom) by account and conversation id, including its full message history. Returns id, read, lastMessageAt, totalMessages, correspondentProfile (including emailAddress and customFields), linkedInAccount, and messages. Required: account_id, id.
- **HeyReach conversations send message** (Send). Send a message to a LinkedIn conversation in HeyReach. Returns a 200 success response with no body.
- **HeyReach conversations set seen** (Set). Mark a HeyReach LinkedIn conversation as seen or unseen. Returns a 200 success response with no body.
- **HeyReach leads search** (Search). Get details of a specific lead in HeyReach by their LinkedIn profile URL. Returns: linkedin_id, imageUrl, firstName, lastName, fullName, location, summary, companyName, companyUrl, position, industry, about, username, emailAddress, connections, followers, experiences, education, profileUrl, enrichedEmailAddress, headline, emailEnrichments.
- **List all HeyReach lead tags** (List). Get tags for a HeyReach lead by LinkedIn profile URL. Returns `tags`, an alphabetically sorted array of tag strings assigned to the lead.
- **Create a HeyReach lead tag** (Create). Add tags to a HeyReach lead without removing existing tags. Returns `newAssignedTags`, the list of newly assigned tag strings. Supply at least one of `leadProfileUrl` or `leadLinkedInId` to identify the lead.
- ...and 19 more tools. Call `tools/list` via the MCP endpoint, or see the full catalog via the API, for the complete set.
