linkedin-mcp-server  by stickerdaniel

LinkedIn data access for AI assistants

Created 5 months ago
389 stars

Top 73.8% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a server for AI assistants, like Claude, to interact with LinkedIn data. It enables scraping profiles and companies, retrieving recommended jobs, and performing job searches, all accessible via a Docker container or local setup.

How It Works

The server leverages a headless Chrome browser instance, controlled via ChromeDriver, to navigate and scrape LinkedIn. It utilizes a session cookie (li_at) for authentication, which needs to be periodically refreshed. The project is built upon the FastMCP framework and incorporates LinkedIn Scraper by joeyism.

Quick Start & Requirements

  • Docker: docker run -e LINKEDIN_COOKIE="li_at=YOUR_COOKIE_VALUE" stickerdaniel/linkedin-mcp-server:latest
  • uvx: uvx --from git+https://github.com/stickerdaniel/linkedin-mcp-server linkedin-mcp-server --cookie "li_at=YOUR_COOKIE_VALUE"
  • Prerequisites: Docker, Chrome browser, and a valid LinkedIn session cookie (li_at). The cookie expires within 30 days.
  • Local Setup: Requires Python 3.12+, ChromeDriver matching Chrome version, and Git.
  • Docs: https://github.com/stickerdaniel/linkedin-mcp-server

Highlighted Details

  • Supports profile scraping, company analysis, job details retrieval, job searching, and recommended jobs.
  • Offers both standard input/output (stdio) and streamable HTTP transport modes.
  • Includes a --get-cookie flag for automated cookie extraction, though manual extraction via Chrome DevTools is also detailed.
  • Provides a Claude Desktop DXT extension for one-click integration.

Maintenance & Community

The project states all tools are functional and actively maintained as of July 2025. Users are encouraged to report issues on GitHub.

Licensing & Compatibility

Licensed under Apache 2.0. Use is subject to LinkedIn's Terms of Service, and web scraping may violate these terms. The tool is intended for personal use only.

Limitations & Caveats

LinkedIn's anti-scraping measures, including CAPTCHAs and mobile app confirmations, can disrupt automated cookie generation or login. Multiple active sessions with the same cookie can lead to invalidation. ChromeDriver version must match the installed Chrome browser.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
2
Star History
97 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.