LinkedIn MCP Server logo

LinkedIn MCP Server

Community
eliasbiondo

๐Ÿ”— A Model Context Protocol (MCP) server for LinkedIn โ€” search people, companies, and jobs, scrape profiles, and get structured data via any MCP-compatible AI client.

Publishereliasbiondo
Repositorylinkedin-mcp-server
LanguagePython
Forks
40
Stars
192
Available tools
0
Transport typestdio, streamable-http
Categories
LicenseMIT
Links
  • Connect tools to AI workflows

    LinkedIn MCP Server exposes MCP capabilities that can be used by compatible AI clients and agents.

  • 0 available tools

    Browse the callable actions below, including names and descriptions when provided by the server.

  • Ready-to-copy setup

    Use the installation snippets to configure this server in your preferred MCP client.

  • Open source signals

    192 stars and 40 forks from the linked repository.

LinkedIn MCP Server

A Model Context Protocol (MCP) server for LinkedIn. Search people, companies, and jobs, scrape profiles, and retrieve structured JSON data from any MCP-compatible AI client.

https://github.com/user-attachments/assets/50cd8629-41ee-4261-9538-40dc7d30294e

Built with FastMCP, Patchright, and a clean hexagonal architecture.


Features

CategoryTools
Peopleget_person_profile ยท search_people
Companiesget_company_profile ยท get_company_posts
Jobsget_job_details ยท search_jobs
Browserclose_browser

Person Profile Sections

The get_person_profile tool supports granular section scraping. Request only the sections you need:

  • Main profile (always included) โ€” name, headline, location, followers, connections, about, profile image
  • Experience โ€” title, company, dates, duration, description, company logo
  • Education โ€” school, degree, dates, description, school logo
  • Contact info โ€” email, phone, websites, birthday, LinkedIn URL
  • Interests โ€” people, companies, and groups followed
  • Honors and awards โ€” title, issuer, description
  • Languages โ€” language name and proficiency level
  • Posts โ€” recent activity with reactions and timestamps
  • Recommendations โ€” received and given, with author details

Company Profile Sections

  • About (always included) โ€” overview, website, industry, size, headquarters, specialties, logo
  • Posts โ€” recent feed posts with engagement metrics
  • Jobs โ€” current open positions

Job Search Filters

The search_jobs tool supports the following filters:

FilterValues
date_postedpast_hour, past_24_hours, past_week, past_month
job_typefull_time, part_time, contract, temporary, internship, other
experience_levelentry, associate, mid_senior, director, executive
work_typeon_site, remote, hybrid
easy_applytrue / false
sort_bydate, relevance

Prerequisites

  • Python 3.12 or later
  • uv package manager
  • A LinkedIn account for authentication

Quick Start

1. Clone and install

bash
git clone https://github.com/eliasbiondo/linkedin-mcp-server.git
cd linkedin-mcp-server
uv sync

2. Install browser

This project uses Patchright (a patched fork of Playwright) for browser automation. You need to install the browser binaries before first use:

bash
uv run patchright install

Windows users: If the command above fails with program not found, run instead:

powershell
uv run python -m patchright install

3. Authenticate with LinkedIn

bash
uv run linkedin-mcp-server --login

A browser window will open. Log in to LinkedIn and the session will be persisted locally at ~/.linkedin-mcp-server/browser-data.

4. Run the server

stdio transport (default โ€” for Claude Desktop, Cursor, and similar clients):

bash
uv run linkedin-mcp-server

HTTP transport (for remote clients, the MCP Inspector, etc.):

bash
uv run linkedin-mcp-server --transport streamable-http --host 0.0.0.0 --port 8000

Client Integration

Claude Desktop / Cursor

Add to your MCP configuration file:

json
{
  "mcpServers": {
    "linkedin": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/linkedin-mcp-server",
        "run", "linkedin-mcp-server"
      ]
    }
  }
}

MCP Inspector

bash
npx @modelcontextprotocol/inspector

Then connect to http://localhost:8000/mcp if using HTTP transport.


Configuration

Configuration follows a strict precedence chain: CLI args > environment variables > .env file > defaults.

CLI Arguments

ArgumentDescriptionDefault
--transportstdio or streamable-httpstdio
--hostHost for HTTP transport127.0.0.1
--portPort for HTTP transport8000
--log-levelDEBUG, INFO, WARNING, ERRORWARNING
--headlessRun browser in headless modetrue
--no-headlessShow browser window (visible mode)โ€”
--loginOpen browser for LinkedIn loginโ€”
--logoutClear stored credentialsโ€”
--statusCheck session statusโ€”

Environment Variables

Create a .env file in the project root:

env
# Server
LINKEDIN_TRANSPORT=stdio
LINKEDIN_HOST=127.0.0.1
LINKEDIN_PORT=8000
LINKEDIN_LOG_LEVEL=WARNING

# Browser
LINKEDIN_HEADLESS=true
LINKEDIN_SLOW_MO=0
LINKEDIN_TIMEOUT=10000
LINKEDIN_VIEWPORT_WIDTH=1280
LINKEDIN_VIEWPORT_HEIGHT=720
LINKEDIN_CHROME_PATH=
LINKEDIN_USER_AGENT=
LINKEDIN_USER_DATA_DIR=~/.linkedin-mcp-server/browser-data

Architecture

The project follows a hexagonal (ports and adapters) architecture with strict layer separation:

src/linkedin_mcp_server/
โ”œโ”€โ”€ domain/              # Core business logic โ€” zero external dependencies
โ”‚   โ”œโ”€โ”€ models/          # Data models (Person, Company, Job, Search)
โ”‚   โ”œโ”€โ”€ parsers/         # HTML to structured data parsers
โ”‚   โ”œโ”€โ”€ exceptions.py    # Domain exceptions
โ”‚   โ””โ”€โ”€ value_objects.py # Immutable configuration and content objects
โ”œโ”€โ”€ ports/               # Abstract interfaces
โ”‚   โ”œโ”€โ”€ auth.py          # Authentication port
โ”‚   โ”œโ”€โ”€ browser.py       # Browser automation port
โ”‚   โ””โ”€โ”€ config.py        # Configuration port
โ”œโ”€โ”€ application/         # Use cases โ€” orchestration layer
โ”‚   โ”œโ”€โ”€ scrape_person.py
โ”‚   โ”œโ”€โ”€ scrape_company.py
โ”‚   โ”œโ”€โ”€ scrape_job.py
โ”‚   โ”œโ”€โ”€ search_people.py
โ”‚   โ”œโ”€โ”€ search_jobs.py
โ”‚   โ””โ”€โ”€ manage_session.py
โ”œโ”€โ”€ adapters/            # Concrete implementations
โ”‚   โ”œโ”€โ”€ driven/          # Infrastructure adapters (browser, auth, config)
โ”‚   โ””โ”€โ”€ driving/         # Interface adapters (CLI, MCP tools, serialization)
โ””โ”€โ”€ container.py         # Dependency injection composition root

Design Decisions

  • Ports and adapters โ€” Domain logic is fully decoupled from infrastructure. The browser engine, MCP framework, and configuration source can all be swapped independently.
  • Dependency injection โ€” A single Container class acts as the composition root and is the only place that imports concrete adapter classes.
  • Structured JSON output โ€” LinkedIn HTML is parsed into typed Python dataclasses, then serialized to JSON for reliable LLM consumption.
  • Session persistence โ€” Browser state is saved to disk, so authentication is required only once.

Development

Setup

bash
uv sync --group dev
uv run pre-commit install

Running tests

bash
uv run pytest

With coverage:

bash
uv run pytest --cov=linkedin_mcp_server

Linting and formatting

This project uses Ruff for both linting and formatting. Pre-commit hooks will run these automatically on each commit.

bash
# Lint
uv run ruff check .

# Lint and auto-fix
uv run ruff check . --fix

# Format
uv run ruff format .

License

This project is licensed under the MIT License. See the LICENSE file for details.


Contributing

Contributions are welcome. Please read the contributing guide for details on the development workflow and submission process.


Disclaimer

This tool is intended for personal and educational use. Scraping LinkedIn may violate their Terms of Service. Use responsibly and at your own risk. The authors are not responsible for any misuse or consequences arising from the use of this software.

Installation

TypingMind
{
  "mcpServers": {
    "eliasbiondo-linkedin-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "linkedin-mcp-server"
      ]
    }
  }
}

Use LinkedIn MCP Server MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once LinkedIn MCP Server is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. You can run MCP locally on your device or connect to a remote MCP server URL.

Option 1: Use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

1

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

  1. Open TypingMind in your browser.
  2. Click the Settings icon.
  3. Go to Advanced Settings.
  4. Open the Model Context Protocol section.
  5. Click Setup Connector and choose This Device.
TypingMind MCP connector setup screen with This Device selected
2

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

  1. Copy the setup command shown by TypingMind.
  2. Open Terminal on macOS or Windows Terminal on Windows.
  3. Paste and run the command.
  4. Approve the package install if Terminal asks you to proceed.
  5. Keep the Terminal window running while using MCP tools.
3

Add LinkedIn MCP Server as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

  1. Wait until the connector status shows Ready.
  2. Click Edit Servers.
  3. Paste the LinkedIn MCP Server MCP server configuration.
  4. Save the server list.
  5. Refresh if you want to confirm the connector is still ready.
TypingMind MCP settings showing active server and Edit Servers button
{
  "mcpServers": {
    "eliasbiondo-linkedin-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "<mcp-server-package>"
      ]
    }
  }
}
4

Use it across models

Save the server list, open Plugins, enable the LinkedIn MCP Server MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

  1. Open the Plugins page in TypingMind.
  2. Enable the LinkedIn MCP Server MCP tools.
  3. Start a chat and choose the AI model you want to use.
  4. Use the MCP tools in chat or assign them to an AI agent.
  5. Switch to another AI model whenever needed without reconnecting MCP.
TypingMind chat using enabled MCP tools with a selected AI model
Can you use LinkedIn MCP Server to help me with this task?
LinkedIn MCP Server
Sure. I read it.
Here is what I found using LinkedIn MCP Server.

Option 2: Add an MCP server URL

Use this when LinkedIn MCP Server is already hosted remotely or your team wants one shared connector that multiple users can access.

1

Open MCP connectors

In TypingMind, go to Plugins, open MCP connectors, then choose Add URL.

  1. Open TypingMind in your browser.
  2. Go to Plugins.
  3. Open MCP connectors.
  4. Click Add URL.
TypingMind Add Custom MCP Server URL form
2

Paste the server URL

Enter the MCP server URL from the provider in the Server URL field. Add a connection name, description, icon, custom HTTP headers, or OAuth client settings if the server requires them.

  1. Paste the MCP server URL from the provider into the Server URL field.
  2. Enter a connection name for LinkedIn MCP Server.
  3. Add a description and icon if you want it to be easier to identify.
  4. Add custom HTTP headers or OAuth client details if the server requires authentication.
3

Create the connection

Click Create connection, then return to the Plugins list and confirm the new MCP connection is active.

  1. Click Create connection.
  2. Return to the MCP connectors list.
  3. Confirm the LinkedIn MCP Server connection appears as active.
  4. Refresh the plugin list if the connection does not appear immediately.
4

Switch models without reconnecting

Start a chat with your preferred model, enable the LinkedIn MCP Server tools from Plugins, and switch to another model whenever needed. The MCP connection stays available to the TypingMind workspace.

  1. Start a new chat in TypingMind.
  2. Select the AI model you want to use.
  3. Enable the LinkedIn MCP Server tools from Plugins.
  4. Ask the model to use the tool when needed.
  5. Switch to another AI model and reuse the same MCP connection.
TypingMind chat using enabled MCP tools with a selected AI model
Can you use LinkedIn MCP Server to help me with this task?
LinkedIn MCP Server
Sure. I read it.
Here is what I found using LinkedIn MCP Server.

Frequently asked questions

What is the LinkedIn MCP Server MCP server used for?

LinkedIn MCP Server is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use LinkedIn MCP Server MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use LinkedIn MCP Server with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use LinkedIn MCP Server MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With LinkedIn MCP Server connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect LinkedIn MCP Server MCP to TypingMind?

LinkedIn MCP Server can be connected in TypingMind with the local MCP connector or by adding a remote MCP server URL. Use the local connector when the server needs access to files, apps, or private resources on your device, and use a server URL when the MCP server is hosted remotely.

What tools does LinkedIn MCP Server MCP provide in TypingMind?

LinkedIn MCP Server exposes MCP capabilities that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use LinkedIn MCP Server MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If LinkedIn MCP Server requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

Related MCP Servers

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter ๐Ÿ‘‡