HeyReach MCP

How to Install and Use HeyReach MCP

HeyReach MCP is a modern server that supports LinkedIn automation through a smart protocol called MCP. It supports both local and cloud setups, so you have options depending on what fits you best. Here’s an easy guide on how to get started with HeyReach MCP.

Installing HeyReach MCP Locally (Using NPX)

If you want to run HeyReach MCP on your computer for local testing or development, the easiest way is using NPX. NPX lets you run the server without installing it permanently.

Follow these steps:

1. Open your command line or terminal.
2. Run this command by replacing YOUR_HEYREACH_API_KEY with your actual API key:

npx heyreach-mcp-server --api-key=YOUR_HEYREACH_API_KEY

This starts HeyReach MCP locally using the stdio transport. You can also add a custom base URL if needed:

heyreach-mcp-server --api-key=YOUR_HEYREACH_API_KEY --base-url=https://api.heyreach.io/api/public

Installing HeyReach MCP Globally (NPM Install)

If you want to install HeyReach MCP globally to use it many times without the NPX prefix, you can install it with NPM:

1. Run this command to install:

npm install -g heyreach-mcp-server

1. Then start the server using:

heyreach-mcp-server --api-key=YOUR_HEYREACH_API_KEY

This will run the server locally just like with NPX.

Running HeyReach MCP as a Remote HTTP Server

For cloud or remote usage, HeyReach MCP supports HTTP streaming transport. This means your server can run online and accept remote connections.

Here’s how to start the HTTP server on your computer or cloud:

1. Use NPX or the global install command:

# Using NPX
npx heyreach-mcp-http

# Or global install
heyreach-mcp-http

# Or start with a custom port (default is 3000)
heyreach-mcp-server --http --port=3001

One-Click Cloud Deployment

If you want to run HeyReach MCP in the cloud quickly, you can deploy it using popular platforms like Railway or Vercel.

Deploying on Railway

To deploy on Railway (good for n8n integration), follow this quick process:

• Click the “Deploy on Railway” button on the MCP GitHub page.
• Sign in to Railway (connect GitHub if needed).
• Select “Deploy from GitHub repo” and search for bcharleson/heyreach-mcp.
• Click deploy and wait for Railway to launch your app.
• Your server will be live on a URL like https://your-app.up.railway.app.

Deploying on Vercel

For the fastest deployment with HTTPS and custom domains:

• Clone and build the repo locally:

git clone https://github.com/bcharleson/heyreach-mcp-server.git
cd heyreach-mcp-server
npm install
npm run build
vercel --prod

• Follow the deployment guide to complete setup and customize your domain.

Using HeyReach MCP with Other Tools

HeyReach MCP works with many clients like Claude Desktop, Cursor IDE, n8n, and more.

For example, to use it with n8n in local stdio mode:

• Create MCP Client credentials in n8n with:

{
  "command": "npx",
  "args": ["[email protected]", "--api-key=YOUR_HEYREACH_API_KEY"],
  "transport": "stdio"
}

• Add the MCP Client node to your workflows and select HeyReach.

For cloud n8n installations, use HTTP streaming with header authentication:

• MCP Endpoint: https://your-deployment.vercel.app/mcp
• Server Transport: HTTP Streamable
• Authentication: Header Auth
• Credential with X-API-Key: YOUR_HEYREACH_API_KEY

This method is secure and easy compared to URL path token passing.

---

By following these simple steps, you can install and use HeyReach MCP either locally or in the cloud, making LinkedIn automation easier and efficient. Make sure to replace the placeholder YOUR_HEYREACH_API_KEY with your real API key from your HeyReach account for all commands and setups.