LinkMCP - hosted LinkedIn MCP server

Your own LinkedIn account, as tools for Claude, ChatGPT, Codex, Cursor and Gemini.

LinkMCP is a hosted MCP server for LinkedIn. You connect your LinkedIn account once in the web app. Then your AI assistant can research people and companies, search LinkedIn (also Sales Navigator, with your own seat), read and answer your LinkedIn messages, post, comment and react (as yourself or as a company page that you administer), manage invitations, and find work emails and mobile numbers. There is nothing to install and nothing to run.

No card. Sign in with an email code or Google. Setup takes about a minute.

This repository is also a plugin with 3 skills for Claude, Codex, Gemini CLI and other AI agents. See Plugin and skills.

Quick start

1. Start the trial at app.linkmcp.io.

2. Add LinkMCP to your AI client with the steps for your client below. Your client opens a browser window. Sign in to LinkMCP and approve.

3. Ask. Copy one of the example prompts.

The endpoint is the same for every client:

https://app.linkmcp.io/api/mcp?ref=github

Transport: Streamable HTTP. Sign-in: OAuth in the browser. If your client cannot do OAuth, send an access key as Authorization: Bearer <key>. You create the key in the web app under API Keys.

What works in the free trial: profile and company lookups, the posts of people and companies, with their comments and reactions, and email and phone finding. To act as yourself on LinkedIn (people search, inbox, invitations, posting, company pages), subscribe and connect your LinkedIn account once in the web app.

Claude (web and desktop)

Add to Claude opens the "Add custom connector" dialog with the name and URL filled in. Or do it by hand:

1. In Claude, open Customize > Connectors, click + and choose Add custom connector.

2. Name it LinkMCP and paste https://app.linkmcp.io/api/mcp?ref=github.

3. Click Add, then Connect, and approve the sign-in window.

On Team and Enterprise plans, an Owner adds the connector in Organization settings > Connectors. Then each member clicks Connect. The Free plan allows one custom connector.

Claude Code

claude mcp add --transport http linkmcp "https://app.linkmcp.io/api/mcp?ref=github"

Then run /mcp in Claude Code, select linkmcp and choose Authenticate.

ChatGPT

Developer mode needs ChatGPT Plus, Pro, Business, Enterprise or Edu (not Free), on the web.

1. Open Settings > Security and login and turn on Developer mode.

2. Go to chatgpt.com/plugins, click +, name it LinkMCP and paste https://app.linkmcp.io/api/mcp?ref=github.

3. Create the connection and approve the sign-in window.

4. In a new chat, click + > Developer mode and turn on LinkMCP.

A workspace admin can turn Developer mode off for a Business or Enterprise workspace.

Codex

Codex CLI:

codex mcp add linkmcp --url "https://app.linkmcp.io/api/mcp?ref=github"

Codex opens the sign-in window. If it does not, run codex mcp login linkmcp.

Codex app and IDE extension: open the settings menu, select MCP servers > Add server, name it LinkMCP, choose Streamable HTTP, paste the endpoint, save, and click Authenticate.

Cursor

Or add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "linkmcp": { "url": "https://app.linkmcp.io/api/mcp?ref=github" }
  }
}

Restart Cursor and approve the sign-in window.

Gemini CLI

Install LinkMCP as a Gemini CLI extension:

gemini extensions install https://github.com/linkmcp-io/linkmcp

Or add only the server:

gemini mcp add --transport http linkmcp "https://app.linkmcp.io/api/mcp?ref=github"

Then start Gemini CLI and run /mcp auth linkmcp to sign in.

Other clients (VS Code, Windsurf, n8n, Make, Zapier)

VS Code:

code --add-mcp '{"name":"linkmcp","type":"http","url":"https://app.linkmcp.io/api/mcp?ref=github"}'

• Windsurf and other MCP clients: add a remote MCP server with the endpoint above.

• n8n, Make, Zapier: use the MCP client node or module of the platform with the endpoint and an access key. Step by step: n8n guide, Make guide.

Related MCP server: linkedin-mcp-pro

Plugin and skills

This repository is also a plugin. The plugin adds the LinkMCP server to your AI client, and it adds 3 skills. A skill is a short set of instructions that tells your AI how to do one task with the LinkMCP tools.

Install the plugin

Claude (web, desktop and Cowork): open Customize > Plugins, choose Add > Add marketplace and enter linkmcp-io/linkmcp. Add the LinkMCP plugin. Then open the Connectors tab of the plugin, connect LinkMCP and approve the sign-in window.

If you added LinkMCP before as a custom connector, remove that connector after you connect the plugin. Then Claude sees one set of LinkMCP tools.

Claude Code:

claude plugin marketplace add linkmcp-io/linkmcp
claude plugin install linkmcp@linkmcp

Then run /mcp, select the LinkMCP server and choose Authenticate. If you added LinkMCP before with claude mcp add, remove it with claude mcp remove linkmcp.

Codex:

codex plugin marketplace add linkmcp-io/linkmcp
codex plugin add linkmcp@linkmcp

Instead of the second command, you can open /plugins in Codex and install LinkMCP. Sign in to LinkMCP when Codex asks.

Gemini CLI: the extension install command in Gemini CLI installs the server and the skills.

Other agents (skills only): this command installs the 3 skills in Claude Code, Codex, Cursor, GitHub Copilot, OpenCode and many other agents. Then add the LinkMCP server to your agent as Quick start shows.

npx skills add linkmcp-io/linkmcp

Try the skills

Prepare me for my call with linkedin.com/company/stripe tomorrow. I will meet
<profile URL>. The goal of the call is a first demo.

Who engaged with this LinkedIn post? <post URL>. Make a lead list of marketing
leaders at B2B software companies.

Find my LinkedIn conversations with no reply for 7 days or more and draft
follow-ups. Show me each draft before you send anything.

The first prompt works in the free trial, except the shared connections. In the free trial, the second prompt reads the comments and the reactions, but not the replies to comments. The inbox skill needs a paid plan, with your LinkedIn account connected.

What the plugin does with your data

The plugin contains only text, configuration files and a logo. It runs no code on your computer. When your AI uses a LinkMCP tool, your AI client sends the tool input to https://app.linkmcp.io/api/mcp, for example a profile URL, a post URL, search words or the text of a message that you approved. LinkMCP gets the data or does the action, and sends back the result. Messages and other actions on LinkedIn use your connected LinkedIn account. Two skills only read LinkedIn data. The inbox skill sends a LinkedIn message only after you approve that message. Privacy policy: app.linkmcp.io/legal/privacy.

If a skill says that the LinkMCP tools are missing, connect the LinkMCP server in your AI client and sign in.

Example prompts

Copy a prompt, replace the parts in angle brackets, and paste it into your AI client.

These work in the free trial:

Look up the company linkedin.com/company/stripe on LinkedIn and give me a short
brief: what they do, how big they are and what they posted recently.

Look up the LinkedIn profile <profile URL> and give me a short brief: role, company,
time in the role, and what they posted in the last month.

Find the work email of <full name> at <company domain> and validate it.

Here are LinkedIn profile URLs: <URLs>. Make a table with name, title, company and
location.

These need a paid plan, with your LinkedIn account connected:

Find heads of RevOps at Series B SaaS companies in the Netherlands. Summarise what
each one posted in the last month.

List my LinkedIn conversations with no reply in 7 days. Check what each person
posted recently and draft a reply for each. Show me the drafts before you send
anything.

Who do I know at <company>? Show my shared connections with their VP of Sales and
draft a short intro request.

Who reacted to my last post? Make a lead list of the marketing directors that I am
not connected to.

List the LinkedIn company pages that I administer. Draft a post for our page about
<topic>. Show it to me, and publish it as the page only after I say OK.

The 35 tools

Tools marked trial work in the free trial. All tools work on every paid plan.

27 tools only read. 8 tools write: send a message, send a connection request, accept, decline or withdraw a connection request, create a post, comment, react, mark a conversation as read, and send feedback. Every tool has a title and a read-only or write annotation, so your client can ask you before a write. Full parameter documentation: llms-full.txt.

Company pages: your AI can post, comment and react as a LinkedIn company page that you administer. It must name the page with as_page. Without as_page, it acts as you. Actions as a page count toward the same daily limits as your own actions.

Pricing

• Free trial: 7 days, no card. The tools marked trial work at once. Connecting your own LinkedIn account needs a paid plan.

• Starter: $19 per month. If you subscribe from a new trial, your first month is $9.50.

• Pro: $49 per month (5x the Starter usage). Max: $199 per month (50x the Starter usage).

• Every paid plan includes every tool. Each plan has a monthly usage allowance and a hard cap, so a looping agent cannot run up a bill. Top-up packs cost $10.

Current prices: app.linkmcp.io/#pricing

Account risk and limits

How LinkMCP protects your LinkedIn account:

• Server-side rate limits on every call, and a warm-up limit for connection requests on new or quiet accounts.

• Your LinkedIn password is not stored. The LinkedIn session runs on dedicated session infrastructure, not in your browser.

• No bulk scraping and no mass exports. No training on your data.

• Read Will my LinkedIn get banned? before you automate at volume.

As with any tool that acts on LinkedIn for you, a restriction cannot be ruled out completely; these limits keep the risk low.

FAQ

Is LinkMCP open source? No. This repository holds the documentation, the client configuration and the skills. The server is a hosted service, and its code is not public. You do not install or run a server on your computer.

Is LinkMCP an official LinkedIn product? No. LinkMCP is an independent product of Third Person Systems LLC. It is not affiliated with or endorsed by LinkedIn, and it does not use an official LinkedIn partner API.

Do I need Sales Navigator? No. LinkMCP works with a normal LinkedIn account. If you have a Sales Navigator seat, the Sales Navigator search tool uses it.

Which AI clients work? Every client that supports remote MCP servers: Claude (web, desktop, Claude Code), ChatGPT (Developer mode), Codex, Cursor, Gemini CLI, VS Code, Windsurf, n8n, Make and Zapier.

Guides

• Connect LinkedIn to ChatGPT

• Connect LinkedIn to Claude

• Connect LinkedIn to n8n

• Connect LinkedIn to Make

• LinkMCP and other LinkedIn MCP options

• LinkedIn MCP vs Expandi and PhantomBuster

• Will my LinkedIn get banned?

• More guides: app.linkmcp.io/guides. Docs for LLMs: llms.txt

Support

• In your AI client, ask it to use the send_feedback tool.

• GitHub issues for documentation and configuration problems.

• Email: info@linkmcp.io

© Third Person Systems LLC. LinkMCP is independent. It is not affiliated with, endorsed by, or built on an official API of LinkedIn.