Skip to main content
Glama
linkedin-mcp

linkedin-mcp

by joaovaleri

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

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

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

Available Tools

41 tools
linkedin_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

    B3.2/5.0

    Scored across 41 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables natural language interaction with LinkedIn, including profile retrieval, job searching, messaging, and post engagement.
      3
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to read and edit LinkedIn profiles including headline, about section, work experience, education, and skills through OAuth 2.0 authentication.
      16
      MIT