HeyReagent LinkedIn MCP server

HeyReagent: a LinkedIn MCP server for your own account

HeyReagent is a hosted MCP server and API for your own LinkedIn account. You sign in once, connect LinkedIn, and give your AI app one address. From then on it can read your inbox, send messages and invitations, search people, and work with posts.

The MCP address: https://api.heyreagent.com/mcp

It is an address, so there is nothing to install or keep running, and it works in apps that live in a browser, such as Claude and ChatGPT on the web.

HeyReagent is not made by, affiliated with or endorsed by LinkedIn, and LinkedIn has not published an MCP server of its own. It is an independent service that acts on your own LinkedIn account, at your direction.

• The site: https://heyreagent.com/linkedin-mcp?utmsource=github&utmmedium=readme
• The docs, with every action: https://heyreagent.com/docs?utmsource=github&utmmedium=readme
• The whole API as an OpenAPI 3.1 file: https://heyreagent.com/openapi.json

This repository holds the steps to connect an AI app, a plugin for Claude Code, and two n8n workflows. The server is hosted; its code is not here.

Before you connect

1. Sign in at heyreagent.com and connect your own LinkedIn account. It is free to start.
2. Claude and ChatGPT sign in to your account and need nothing more. For the others, make a key on the thread page: Menu, then Developers. It is shown once.

Connect your AI app

Claude

Signs in to your account. No key.

1. Open Customize, then Connectors.
2. Click + Add, then Add custom connector.
3. Type a name, paste the address, and click Continue.
4. Keep the sign-in settings Claude found, continue, and click Add. Sign in to HeyReagent when Claude asks.
5. In a chat, press + at the lower left, then Connectors, to switch it on.

ChatGPT

Signs in to your account. No key.

1. Open Settings, then Security and login, and turn on Developer mode.
2. Go to ChatGPT Plugins, select the plus button, type a name and a description, enter the address, and create the connection.
3. Sign in to HeyReagent when ChatGPT asks.
4. In a chat, choose Developer mode from the plus menu and select it.

Muse

Uses your key.

1. Send Muse the message below, as it is.
2. Muse answers with a card for the connector. Press Connect on it, then Continue, and paste your key in the form. The key goes there, not in the chat.
3. Muse asks whether it may share information with api.heyreagent.com. “Always allow this site” stops it asking before every request. “Allow once” allows the next one only.
4. Muse lists the actions and runs the check. Then ask it for what you want.

Create a custom connector called HeyReagent for my LinkedIn. It is a remote MCP server over streamable HTTP at https://api.heyreagent.com/mcp. Every request needs the header "Authorization: Bearer" followed by my key. Ask me for the key in your secure form, not in this chat. Then list its tools and run get_my_profile to check that it works.

Claude Code

Uses your key.

1. Run this in a terminal, with your own key where it says YOUR_KEY.

claude mcp add --transport http heyreagent https://api.heyreagent.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Or install the plugin in this repository, which signs in to your account and needs no key. See The plugin.

Cursor

Uses your key.

1. Put this in .cursor/mcp.json in your project, or in ~/.cursor/mcp.json to have it everywhere, with your own key where it says YOUR_KEY.

{
  "mcpServers": {
    "heyreagent": {
      "url": "https://api.heyreagent.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

n8n

Uses your key.

1. Add an MCP Client Tool node to your agent.
2. Endpoint: the address above. Server Transport: HTTP Streamable.
3. Authentication: Bearer Auth, with your key.

The plugin

Shortened. The full README is on GitHub.