How do I use linkedin-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@linkedin-mcp sign me in to LinkedIn and show my profile" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

linkedin-mcp

by echohello-dev

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

@echohello/linkedin-mcp

LinkedIn MCP server for Claude, Codex, OpenCode and other MCP clients. TypeScript, stdio transport, member OAuth, and a small tool surface for the signed-in member's profile and text posts.

npm install
npm run build
LINKEDIN_CLIENT_ID=... LINKEDIN_CLIENT_SECRET=... node dist/index.js

Why

LinkedIn does not ship an MCP server. This one speaks the public member APIs only: three-legged OAuth, OpenID userinfo, and a text post on behalf of the signed-in member. It does not take a browser session cookie, and it does not read other people's data, send messages, or send connection requests.

Related MCP server: linkedin-mcp-server

What you need

Create an app in the LinkedIn developer portal and add:

Sign In with LinkedIn using OpenID Connect (openid, profile, email)
Share on LinkedIn (w_member_social)

http://127.0.0.1:53682/callback

Tools

Tool	Purpose
`linkedin_login`	Start member sign-in and return the approval URL
`linkedin_finish_login`	Wait for the loopback callback, or exchange a pasted redirect URL
`linkedin_status`	Show whether a session is stored, without returning tokens
`linkedin_profile`	Read the signed-in member's OpenID profile
`linkedin_create_post`	Publish a text post as that member
`linkedin_logout`	Delete the stored session

Configure

Variable	Required	Purpose
`LINKEDIN_CLIENT_ID`	yes	App client id
`LINKEDIN_CLIENT_SECRET`	yes	App client secret
`LINKEDIN_REDIRECT_URI`	no	Defaults to `http://127.0.0.1:53682/callback`
`LINKEDIN_SCOPES`	no	Space-separated override of the default member scopes
`LINKEDIN_VERSION`	no	Posts API version header, `YYYYMM`. Defaults to `202609`
`LINKEDIN_TOKEN_PATH`	no	Session file. Defaults to `~/.config/echohello/linkedin-mcp/tokens.json`

The session file is mode 0600. Tool results never include the access token.

LINKEDIN_CLIENT_ID=... LINKEDIN_CLIENT_SECRET=... node dist/index.js login

MCP client config:

{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/absolute/path/to/linkedin-mcp/dist/index.js"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your-client-id",
        "LINKEDIN_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Out of scope

Messaging, invitations, company-page posting, image and video uploads, and reading the member's feed all need products this server does not request. r_member_social is a restricted permission and is not part of the default scope set.

Develop

npm test
npm run typecheck

Available Tools

6 tools

linkedin_create_postA

Publish a text post as the signed-in member. Requires the Share on LinkedIn product (w_member_social).

Inputs: commentary (required), visibility.

linkedin_finish_loginA

Finish member sign-in. Waits for the loopback callback, or exchanges a pasted redirect URL. Saves the session locally.

Inputs: redirectUrl, timeoutSeconds.

linkedin_loginA

Start LinkedIn member sign-in. Returns a URL the member must open and approve. When the redirect URI is loopback, a local listener waits for the callback. Tokens are never returned.

Inputs: no named parameters.

linkedin_logoutA

Delete the stored member session.

Inputs: no named parameters.

linkedin_profileA

Read the signed-in member's OpenID profile (name, email, picture, member id).

Inputs: no named parameters.

linkedin_statusB

Show whether a member session is stored. Does not return tokens.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.9/5.0

Scored 2026-09-27 16:35 across 6 tools

Disambiguation4/5

Each tool has a distinct function: the login/finish_login pair forms a clear two-step flow, and status, logout, profile, and create_post are all sharply separated. The only mild risk is confusion between linkedin_login and linkedin_finish_login, but descriptions disambiguate the sequence.

Naming Consistency5/5

All six tools use a consistent linkedin_ prefix with snake_case verb/noun naming (linkedin_login, linkedin_finish_login, linkedin_status, etc.). The convention is predictable throughout.

Tool Count5/5

Six tools is well-scoped for an auth-plus-basic-actions server, with each tool earning its place across the session lifecycle and core member operations.

Completeness4/5

The auth lifecycle (login, finish, status, logout) plus profile read and post creation covers the core member flow. Minor gaps exist—no post delete/list, no profile update—but the surface is coherent for its apparent scope.

Maintenance

ActivitySlowing

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

LinkedIn MCP ServerA
ai.com.mcp
LinkedIn API as MCP tools to retrieve profile data and publish content. Powered by HAPI MCP.
Social Media Communication Marketing
37
https://linkedin.run.mcp.com.ai/mcp
HeyReagent LinkedIn MCPA
io.github.linglistack
A hosted LinkedIn MCP server for your own account. Paste one address into Claude, ChatGPT, Cursor or n8n to read your inbox, send messages and invitations, and search people. Free to start. Not made by LinkedIn.
Communication Search Social Media
10312
https://api.heyreagent.com/mcp
LinkedIn Ads MCP Server by AdKit
io.github.adkit
LinkedIn Ads MCP server: run LinkedIn campaigns, ad groups, ads and reports from AI.
1
https://mcp.adkit.so/linkedin-ads
PerfectPostA
social.perfectpost.mcp
PerfectPost is a LinkedIn content management platform. This MCP server gives AI assistants read and write access to a user's PerfectPost account: published posts with their engagement analytics, drafts lifecycle (create / edit / schedule), and LinkedIn profile data.
Social Media Marketing Content Management Systems
2
https://mcp.perfectpost.social/mcp

Related MCP Servers

linkedin-mcp
Social Media Communication
KpihX
A
license
Not graded
quality
D
maintenance
MCP server for LinkedIn, enabling posting, liking, commenting, and profile retrieval via official OAuth 2.0. Features CLI, HTTP admin, and optional Telegram bot.
Updated 7 months ago (2026-03-29 16:44 UTC)
14 npm
MIT
linkedin-mcp-server
Ramankumar6566
A
license
Not graded
quality
D
maintenance
MCP server for LinkedIn API integration. Enables authentication, profile access, connections, search, messaging, and feed management via OAuth2.
Updated 4 months ago (2026-07-21 16:56 UTC)
MIT
LinkedIn Poster MCP
Social Media Marketing
codebytemirza
A
license
Not graded
quality
D
maintenance
MCP server that lets you publish text and image posts to LinkedIn, fetch your profile, and check auth status using natural language.
Updated 3 months ago (2026-08-12 12:54 UTC)
MIT
linkedin-mcp-server
Social Media Marketing
sviera91
A
license
A
quality
D
maintenance
Local-first MCP server using LinkedIn's official OAuth and REST APIs to connect a member account, read profile, and publish text posts.
Updated 11 days ago (2026-11-03 04:32 UTC)
4
135 npm
MIT

@echohello/linkedin-mcp

Why

What you need

Tools

Configure

Out of scope

Develop

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

linkedin-mcp

linkedin-mcp-server

LinkedIn Poster MCP

linkedin-mcp-server