linkedin-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@linkedin-mcp add a work experience at Google"
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
A Model Context Protocol (MCP) server that gives Claude full control over your LinkedIn profile — read, edit, add, remove entries, and publish posts, all from a single conversation.
Built with Playwright for browser automation and the official MCP TypeScript SDK.
Table of Contents
Related MCP server: kaushik-linkedin-mcp
Features
No LinkedIn API access required — works through real browser automation, so you don't need an approved LinkedIn developer app.
Persistent session — log in once, reuse the session for weeks.
Full profile coverage — read and edit every section: experience, education, skills, certifications, languages, projects, honors, volunteer, publications, courses, organizations, test scores, and patents.
Remove entries — delete any entry from any section by matching text.
Publish posts — text posts and image posts both supported.
Portable — profile slug is configured via environment variable; no hardcoded paths.
Tools
Read
Tool | Description |
| Fetch name, headline, location, company, about, industry |
| Read phone, email, website, twitter |
| Read all profile sections with optional text filter |
| Fetch recent posts from the activity page |
Edit intro / basic info
Tool | Description | Parameters |
| Update profile headline |
|
| Rewrite the About/Summary section |
|
| Update the Industry/Setor field |
|
| Update phone and/or address |
|
| Enable or disable Open to Work |
|
Add entries
Tool | Description |
| Add a work experience entry |
| Add an education entry |
| Add a skill |
| Add a certification |
| Add a language and proficiency level |
| Add a project |
| Add a volunteer experience |
| Add an honor or award |
| Add a publication |
| Add a course |
| Add an organization membership |
| Add a test score (e.g. TOEFL, GRE) |
| Add a patent |
Remove
Tool | Description | Parameters |
| Remove any entry from any section by matching text |
|
Valid sections for linkedin_remove_entry: experience, education, skills, certifications, languages, projects, honors, volunteer, publications, courses, organizations, test_scores, patents
Posts
Tool | Description | Parameters |
| Publish a plain text post |
|
| Publish a post with a local image |
|
Auth / Diagnostics
Tool | Description |
| Open browser for manual login and save session |
| Diagnostic: dump all buttons on the profile page |
Prerequisites
Node.js v18 or later
npm v9 or later
Claude Code (or any other MCP-compatible client)
A real LinkedIn account you're allowed to automate
Installation
Automated setup (recommended)
git clone https://github.com/khalidstark/linkedin-mcp.git
cd linkedin-mcp
chmod +x setup.sh
./setup.shThe script will:
Check for Node.js
Install npm dependencies
Install the Playwright Chromium browser
Build the TypeScript source
Ask for your LinkedIn profile slug and output the config block to paste into
~/.claude.json
Manual setup
git clone https://github.com/khalidstark/linkedin-mcp.git
cd linkedin-mcp
npm install
npx playwright install chromium
npm run buildConnect to Claude Code
Add the following to ~/.claude.json under mcpServers (replace the path and slug):
{
"mcpServers": {
"linkedin-editor": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/linkedin-mcp/dist/index.js"],
"env": {
"LINKEDIN_PROFILE_SLUG": "your-profile-slug"
}
}
}
}Your profile slug is the last segment of your LinkedIn URL:
https://www.linkedin.com/in/your-profile-slug
Restart Claude Code after editing the config. Verify with:
claude mcp listOther MCP clients
For Claude Desktop, Cursor, and other MCP-compatible clients, use the same node /path/to/linkedin-mcp/dist/index.js command and pass LINKEDIN_PROFILE_SLUG in their environment config.
Usage
1. Log in (first time only)
"Call linkedin_login"A Chromium window will open. Log in to LinkedIn normally (including 2FA/captcha). Once you land on the feed, the session is persisted in the Chrome profile directory at ~/.linkedin-mcp-chrome-profile/ and reused on future calls.
2. Read your full profile
"Read all my LinkedIn profile sections"3. Update your profile from a CV
"Here is my CV: [paste]. Update my LinkedIn headline and summary, add all my skills and certifications."4. Remove an entry
"Remove the 'Old Company' entry from my experience section"5. Publish a post
"Write a short post about my new certification and publish it on LinkedIn."
"Post this image to LinkedIn with caption 'Excited to share this!': /home/user/photo.jpg"Image paths must be absolute.
Session Management
The login session is persisted in the Chrome profile directory at ~/.linkedin-mcp-chrome-profile/ (cookies + local storage). It lives in your home directory, outside the repo, so it is never committed. If the session expires, call linkedin_login again.
To force a fresh login:
rm -rf ~/.linkedin-mcp-chrome-profileProject Structure
linkedin-mcp/
├── src/
│ ├── index.ts # MCP server + tool registration
│ ├── linkedin.ts # LinkedIn automation functions
│ └── browser.ts # Playwright browser/session lifecycle
├── setup.sh # Automated setup script for new machines
├── dist/ # Compiled output (generated, not committed)
├── package.json
└── tsconfig.jsonDevelopment
npm run build # Compile TypeScript → dist/Rebuild and restart the MCP client to pick up changes. Claude Code reloads servers on restart, not on file change.
Troubleshooting
Server failed to connect
Check that the path to
dist/index.jsis correct andnpm run buildhas been run.Verify
LINKEDIN_PROFILE_SLUGis set in theenvblock of your MCP config.Ensure Node.js is accessible from the PATH that Claude Code's subprocess inherits.
npx playwright install chromium fails
Re-run with: DEBUG=pw:install npx playwright install chromium. On Linux you may also need npx playwright install-deps chromium for system libraries.
LinkedIn shows a captcha or security check
Solve it manually in the Chromium window opened by linkedin_login. The session is saved only after you reach the LinkedIn feed.
Session keeps expiring
LinkedIn invalidates sessions on password changes or security triggers. Delete ~/.linkedin-mcp-chrome-profile and call linkedin_login again.
A tool runs but the profile doesn't update LinkedIn occasionally ships UI changes that break selectors. Open an issue with the failing tool name and a redacted screenshot.
"Browser closed unexpectedly"
Another linkedin-mcp instance may be holding the profile lock. Kill stray chromium processes and retry.
Disclaimer
This project uses browser automation to interact with LinkedIn. Automating LinkedIn actions may violate their User Agreement. Use it on your own account, at your own discretion. The author is not responsible for any account restrictions or suspensions resulting from this tool.
License
MIT
Available Tools
41 toolslinkedin_add_certificationC
Add a certification to the LinkedIn profile
Inputs: name (required), issuer (required), issueDate, credentialId, +1 more.
linkedin_add_courseC
Add a course to the LinkedIn profile
Inputs: name (required), number, associatedWith.
linkedin_add_educationC
Add an education entry to the LinkedIn profile
Inputs: school (required), field, grade, degree, +3 more.
linkedin_add_experienceB
Add a work experience entry to the LinkedIn profile
Inputs: title (required), company (required), startYear (required), startMonth (required), +5 more.
linkedin_add_honorC
Add an honor or award to the LinkedIn profile
Inputs: title (required), year, month, issuer, +1 more.
linkedin_add_languageB
Add a language to the LinkedIn profile
Inputs: language (required), proficiency (required).
linkedin_add_organizationC
Add an organization membership to the LinkedIn profile
Inputs: name (required), endYear, endMonth, position, +4 more.
linkedin_add_patentC
Add a patent to the LinkedIn profile
Inputs: title (required), date, number, office, +2 more.
linkedin_add_projectC
Add a project to the LinkedIn profile
Inputs: name (required), url, endYear, endMonth, +4 more.
linkedin_add_publicationC
Add a publication to the LinkedIn profile
Inputs: title (required), publisher (required), url, year, +2 more.
linkedin_add_skillB
Add a skill to the LinkedIn profile
Inputs: skill (required).
linkedin_add_test_scoreB
Add a test score to the LinkedIn profile (e.g. TOEFL, GRE)
Inputs: name (required), score (required), date, description.
linkedin_add_volunteerC
Add a volunteer experience to the LinkedIn profile
Inputs: org (required), role (required), cause, endYear, +5 more.
linkedin_close_sessionA
Close the browser session and release its resources. The next tool call will relaunch the browser and reuse the saved login.
Inputs: no named parameters.
linkedin_connect_with_personA
Send a LinkedIn connection request to a person, or accept their pending invite if they already sent you one. This affects a real third party — call once with confirm omitted/false to preview, then again with confirm: true to actually send/accept it.
Inputs: profileSlugOrUrl (required), note, confirm.
linkedin_create_image_postB
Publish a LinkedIn post with a local image attachment
Inputs: text (required), imagePath (required).
linkedin_create_text_postB
Publish a plain text post on LinkedIn
Inputs: text (required).
linkedin_get_company_employeesC
List employees at a company, with an optional keyword filter (e.g. job title)
Inputs: companySlug (required), keywordFilter.
linkedin_get_company_postsB
Get recent posts from a company's LinkedIn feed
Inputs: companySlug (required).
linkedin_get_company_profileA
Get a LinkedIn company's about page (overview, industry, size, headquarters) plus its numeric company URN, usable as the currentCompany filter in linkedin_search_people
Inputs: companySlug (required).
linkedin_get_contact_infoA
Read current contact information (phone, website, twitter, email)
Inputs: no named parameters.
linkedin_get_conversationA
Read a specific messaging conversation by matching the contact's name in the inbox
Inputs: threadIdOrUsername (required).
linkedin_get_feedB
Get recent posts from the authenticated user's LinkedIn home feed
Inputs: limit.
linkedin_get_inboxB
List recent conversations from the LinkedIn messaging inbox
Inputs: limit.
linkedin_get_job_detailsB
Get the full description of a specific job posting
Inputs: jobIdOrUrl (required).
linkedin_get_profileA
Fetch current LinkedIn profile info (name, headline, location, company, about, industry)
Inputs: no named parameters.
linkedin_get_recent_postsB
Fetch recent posts from LinkedIn activity page
Inputs: no named parameters.
linkedin_get_sectionsA
Read profile sections (experience, education, skills, etc.) and optionally filter by a search term
Inputs: search, sections, maxScrolls.
linkedin_get_sidebar_profilesA
Extract suggested-profile links ('People also viewed', 'People you may know') from a profile page
Inputs: profileSlugOrUrl.
linkedin_loginB
Open browser for manual LinkedIn login
Inputs: no named parameters.
linkedin_remove_entryB
Remove an entry from a LinkedIn profile section by matching text. Sections: experience, education, skills, certifications, languages, projects, honors, volunteer, publications, courses, organizations, test_scores, patents
Inputs: search (required), section (required).
linkedin_search_companiesB
Search LinkedIn for companies by keywords
Inputs: keywords (required).
linkedin_search_conversationsA
Search the LinkedIn messaging inbox by keyword
Inputs: keyword (required).
linkedin_search_jobsC
Search LinkedIn job postings with keyword, location, and filters
Inputs: keywords (required), sortBy, jobType, location, +4 more.
linkedin_search_peopleB
Search LinkedIn for people by keywords, with optional location, connection-degree, and current-company filters
Inputs: keywords (required), location, currentCompany, connectionDegree.
linkedin_send_messageA
Send a direct message to a LinkedIn connection. This affects a real third party — call once with confirm omitted/false to preview, then again with confirm: true to actually send it.
Inputs: message (required), profileSlugOrUrl (required), confirm.
linkedin_set_open_to_workA
Enable or disable the Open to Work status. When enabling, visibility controls who sees it: 'recruiters' (no public badge, visible only to LinkedIn recruiters — the default) or 'all' (public #OpenToWork photo frame visible to everyone, including your company).
Inputs: enable (required), visibility.
linkedin_update_contact_infoB
Update contact information (phone number and/or address)
Inputs: phone, address.
linkedin_update_headlineC
Update the profile headline
Inputs: headline (required).
linkedin_update_industryB
Update the Industry/Setor field
Inputs: industry (required).
linkedin_update_summaryC
Update the About/Summary section
Inputs: summary (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 41 tools
Most tools have clearly distinct purposes, but some overlap could cause confusion (e.g., linkedin_get_recent_posts vs linkedin_get_feed, or multiple search tools). However, descriptions are sufficiently detailed to disambiguate in most cases.
All tools follow a uniform linkedin_verb_noun convention in snake_case, making it easy to infer function from name. No mixing of styles or inconsistent patterns.
41 tools is on the high side but justified by LinkedIn's broad feature set covering profile management, search, messaging, and posts. However, some tools (e.g., many individual add_* tools) could potentially be combined without sacrificing clarity.
Covers most core LinkedIn operations: profile CRUD, search, messaging, posts, and connections. Minor gaps exist such as no tool to delete or update a post, but the overall surface is comprehensive.
Related MCP Connectors
Full LinkedIn access for AI agents: leads, messaging, and campaigns with activity limits built in.
LinkedIn jobs, companies and people for AI agents, plus messages and invites via your own account.
LinkedIn for AI agents: inbox, invitations, Sales Navigator search, posts, jobs, quotas, webhooks.
Give AI agents the LinkedIn tools to find, qualify, engage, and follow up with prospects.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI assistants to interact with LinkedIn by scraping profiles, companies, job postings, and getting personalized job recommendations using authenticated browser automation.1711,806 PyPI4,230Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables Claude AI to interact with LinkedIn through browser automation, including profile reading, people and job search, company research, post publishing, and profile editing.MIT
- AlicenseNot gradedqualityBmaintenanceEnables natural language interaction with LinkedIn, including profile retrieval, job searching, messaging, and post engagement.3Apache 2.0
- AlicenseAqualityDmaintenanceEnables AI assistants to read and edit LinkedIn profiles including headline, about section, work experience, education, and skills through OAuth 2.0 authentication.16MIT