Skip to main content

How to integrate HeyReach MCP Connector with Claude

Step by step guide to help you seamlessly connect and test HeyReach MCP Connector with Claude

HeyReach MCP Connector is available currently on all plans, and can be connected to all workspaces you own.
​
​To be able to follow instructions and connect HeyReach MCP connector with Claude you need to have Admin role in your HeyReach Workspace or Admin's permission to manage integrations in the HeyReach workspaces you want to connect.

If you have doubts on MCP availability on Claude's side, please consult their documentation on MCP Servers.

What can you do with HeyReach MCP Connector plugged into Claude

Reading data never changes anything. Claude says whether it only reads, changes, overwrites or deletes data, so your assistant can ask you to confirm before running it.

Area

Read

Change

Workspaces

List the workspaces on the connection

None

Campaigns

List campaigns, get a campaign, its sequence and leads, campaigns a lead is in

Create a campaign or copy one as a template; update settings, schedule, senders or sequence; start, pause or resume; add leads; stop a lead

Leads

Get a lead, its tags

Add or replace tags

Lists

List lists, get a list, its leads and companies, lists a lead is in

Create a list; add or delete leads

Inbox

List conversations, read a conversation

Send a LinkedIn message

Sender accounts

List LinkedIn accounts, get one, view a sender’s network

None

Statistics

Overall and per-campaign stats for a date range

None

Blacklist

List blacklisted leads and companies

Add or remove leads and companies

Voice notes

Voices, sender voices, usage, static clips, gender detection

Assign or remove voices, delete a custom voice

Webhooks

List webhooks, get one

Create, update or delete a webhook


How to Connect HeyReach to Claude step by step

You can follow video guidance or written instructions that follow:

Step 1: Copy your HeyReach MCP server URL

  1. Go to Settings -> Integrations.

  2. Select HeyReach MCP Server -> Get MCP key.

  3. In the Claude, ChatGPT & Codex section, copy the URL.


Step 2: Add HeyReach MCP in Claude

  1. Log in to your Claude account.

  2. Go to Customize -> Connectors -> Add -> Add custom connector.

  3. Name it HeyReach Claude (or anything you'd like) and paste the URL you copied from HeyReach integrations page.

  4. Follow the steps on screen if you're asked to finish connecting to HeyReach. Click Continue connecting button and log in to your Claude account if necessary.

⚠️ If you're already connected to HeyReach MCP in Claude, when you see the Connected page, click Open Claude if you use the Claude desktop app.

If your browser asks permission to open Claude, click Open Claude again. Claude will confirm that HeyReach MCP is connected.


Step 3: Sign in and choose your workspaces

  1. After you connect, a HeyReach screen titled "Claude wants to access your HeyReach workspaces" will ask for access.

  2. Open the Workspaces dropdown and select the workspaces you want to connect. You can pick one, several, or Select all.

    ☝🏼 In the selected workspaces, Claude can:

    • Read and change campaigns, leads, lists, and webhooks.

    • Send LinkedIn messages from your senders.

    • Move data between those workspaces.

  3. Click the blue Allow button.

  4. If you are connecting for the first time, you'll be asked to choose when is Claude allowed to use Read-only tools and Write/delete tools.

  5. Select Tool permissions based on your own needs and expectations.


Step 4: Test the integration

  1. Start a new chat in Claude.

  2. Enter a prompt, such as: "Use the HeyReach MCP to list all LinkedIn accounts connected to HeyReach."

  3. You should now see your LinkedIn accounts and their authentication status directly from HeyReach.


Disconnecting HeyReach MCP

To remove access for all Claude, ChatGPT, and Codex connectors at once:

  1. Go to Settings -> Integrations -> HeyReach MCP Server and

  2. Click Disconnect Claude/ChatGPT/Codex from this workspace.

  3. Confirmation window will pop-up asking you to confirm the following before removal: "Every app connected through sign-in will lose access to this workspace and will have to connect again to get it back. Their access to other workspaces is not affected."

    ⚠️ This action disconnects workspaces from ChatGPT, Codex, and Claude all at once.


☝🏼 Keep in mind

  • HeyReach MCP Connector is currently in Beta. Some steps or screens may change as we improve it.

  • The AI assistant makes real changes. Messages it sends reach real people on LinkedIn, so check what it plans to do before you approve it.

  • The AI assistant only sees the workspaces you selected. It can't access any other workspace.

  • New workspaces aren't added automatically. Connect again to include a workspace you joined later.


Frequently asked questions

Do I need an API key to connect ChatGPT, Codex, or Claude?

No, you don't need an API key. You connect by signing in with your HeyReach account.

Why don't I see Integrations in my HeyReach account/workspace?

You only see Integrations based on your user permissions in HeyReach and whether you're allowed to manage integrations. Ask your workspace admin to give you that permission.

Why does the AI assistant ask which workspace to use?

The AI assistant asks which workspace to use when you connected more than one. This keeps data from different workspaces separate.

Can I connect ChatGPT, Codex, and Claude at the same time?

Yes, you can connect all three. Each assistant is connected separately.

Have questions about HeyReach MCP? Chat with our support team via the widget in the bottom-right corner. 👩🏽‍💻

Did this answer your question?