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

• Features
• Tools
• Prerequisites
• Installation
• Connect to Claude Code
• Usage
• Session Management
• Project Structure
• Development
• Troubleshooting
• Disclaimer
• License

---

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
linkedin_get_profile	Fetch name, headline, location, company, about, industry
linkedin_get_contact_info	Read phone, email, website, twitter
linkedin_get_sections	Read all profile sections with optional text filter
linkedin_get_recent_posts	Fetch recent posts from the activity page

Edit intro / basic info

Tool	Description	Parameters
linkedin_update_headline	Update profile headline	headline
linkedin_update_summary	Rewrite the About/Summary section	summary
linkedin_update_industry	Update the Industry/Setor field	industry
linkedin_update_contact_info	Update phone and/or address	phone?, address?
linkedin_set_open_to_work	Enable or disable Open to Work	enable (boolean)

Add entries

Tool	Description
linkedin_add_experience	Add a work experience entry
linkedin_add_education	Add an education entry
linkedin_add_skill	Add a skill
linkedin_add_certification	Add a certification
linkedin_add_language	Add a language and proficiency level
linkedin_add_project	Add a project
linkedin_add_volunteer	Add a volunteer experience
linkedin_add_honor	Add an honor or award
linkedin_add_publication	Add a publication
linkedin_add_course	Add a course
linkedin_add_organization	Add an organization membership
linkedin_add_test_score	Add a test score (e.g. TOEFL, GRE)
linkedin_add_patent	Add a patent

Remove

Tool	Description	Parameters
linkedin_remove_entry	Remove any entry from any section by matching text	section, search

Valid sections for linkedin_remove_entry: experience, education, skills, certifications, languages, projects, honors, volunteer, publications, courses, organizations, test_scores, patents

Posts

Tool	Description	Parameters
linkedin_create_text_post	Publish a plain text post	text
linkedin_create_image_post	Publish a post with a local image	text, imagePath

Auth / Diagnostics

Tool	Description
linkedin_login	Open browser for manual login and save session
linkedin_dump_profile_buttons	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.sh

The script will:

1. Check for Node.js
2. Install npm dependencies
3. Install the Playwright Chromium browser
4. Build the TypeScript source
5. 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 build

---

Connect 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 list

Other 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-profile

---

Project 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.json

---

Development

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.js is correct and npm run build has been run.
• Verify LINKEDIN_PROFILE_SLUG is set in the env block 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