Skip to content
Back to search

linkedin-scraper-mcp

Read-only MCP server for researching LinkedIn profiles, companies and jobs through your own browser session. Modified fork of stickerdaniel/linkedin-mcp-server (Apache-2.0). Not affiliated with LinkedIn.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/guaitolinii--linkedin-scraper-mcp/badge.svg)](/listings/guaitolinii--linkedin-scraper-mcp)

HTML

<a href="/listings/guaitolinii--linkedin-scraper-mcp"><img src="/api/listings/guaitolinii--linkedin-scraper-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires [uv](https://docs.astral.sh/uv/getting-started/installation/) and Python 3.12 or newer.

uv tool install git+https://github.com/Guaitolinii/linkedin-scraper-mcp

or, from a local checkout:

uv tool install .

> **Do not run `uvx linkedin-scraper-mcp`.** That name on PyPI belongs to a different, unrelated package, and `uvx` would install and run its code. Always install from this repository, as above.

Pin to a tag or commit when you want updates to be a decision rather than a surprise:

uv tool install git+https://github.com/Guaitolinii/linkedin-scraper-mcp@<tag>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 121 lines
  1. # linkedin-scraper-mcp
  2. A **read-only** MCP server that lets an AI assistant research LinkedIn profiles, companies and jobs through **your own browser session**. It can look things up on its own. It cannot send messages, send connection requests, or change anything on your account.
  3. > Independent open-source project. Not affiliated with, endorsed by or sponsored by LinkedIn or Microsoft. LinkedIn is a trademark of LinkedIn Corporation.
  4. This is a modified version of [linkedin-mcp-server](https://github.com/stickerdaniel/linkedin-mcp-server) by Daniel Sticker, used under the Apache License 2.0. See [What changed](#what-changed-from-the-original) and [NOTICE](NOTICE).
  5. ## Tools
  6. All 13 tools only read.
  7. | Tool | Description |
  8. |------|-------------|
  9. | `get_person_profile` | Read profile sections: experience, education, skills, projects, volunteering, posts. |
  10. | `get_my_profile` | Read your own profile, with the same section selection. |
  11. | `search_people` | Find people by keyword, location, degree, company and mutual connections. |
  12. | `get_company_profile` | Read company information, with optional sections for posts and open jobs. |
  13. | `get_company_posts` | Read recent posts from a company's feed, with links to the originals. |
  14. | `get_company_employees` | Find company employees, optionally filtered by name, title or skill. |
  15. | `search_companies` | Find companies by keyword and return links to their profiles. |
  16. | `search_jobs` | Find job postings by keyword and location, with job IDs for details. |
  17. | `get_job_details` | Read a posting's description, requirements and company details. |
  18. | `get_job_apply_url` | Check whether a job uses Easy Apply or links to the employer's application. |
  19. | `get_saved_jobs` | List your saved job postings. |
  20. | `get_session_status` | Check your saved login and browser state without opening a browser. |
  21. | `close_session` | Close the shared browser without deleting your saved login. |
  22. ## Install
  23. Requires [uv](https://docs.astral.sh/uv/getting-started/installation/) and Python 3.12 or newer.
  24. ```bash
  25. uv tool install git+https://github.com/Guaitolinii/linkedin-scraper-mcp
  26. ```
  27. or, from a local checkout:
  28. ```bash
  29. uv tool install .
  30. ```
  31. > **Do not run `uvx linkedin-scraper-mcp`.** That name on PyPI belongs to a different, unrelated package, and `uvx` would install and run its code. Always install from this repository, as above.
  32. Pin to a tag or commit when you want updates to be a decision rather than a surprise:
  33. ```bash
  34. uv tool install git+https://github.com/Guaitolinii/linkedin-scraper-mcp@<tag>
  35. ```
  36. ## Log in
  37. ```bash
  38. linkedin-scraper-mcp --login
  39. ```
  40. A browser window opens. Sign in to LinkedIn yourself (2FA and captchas included). The session is saved under `~/.linkedin-scraper-mcp/profile` and reused until it expires. On Windows this is the reliable path.
  41. Optional shortcut: if you are already signed in to LinkedIn in Chrome, Edge, Brave and similar browsers, `linkedin-scraper-mcp --import-from-browser` copies that session instead. Recent Chrome and Edge versions encrypt cookies in a way that cannot be read without elevation (app-bound "v20" encryption), so on Windows this often fails and `--login` is what works.
  42. To forget the session: `linkedin-scraper-mcp --logout`.
  43. ## Use it from an MCP client
  44. Claude Code:
  45. ```bash
  46. claude mcp add linkedin -- linkedin-scraper-mcp
  47. ```
  48. Any client that takes a JSON config:
  49. ```json
  50. {
  51. "mcpServers": {
  52. "linkedin": {
  53. "command": "linkedin-scraper-mcp"
  54. }
  55. }
  56. }
  57. ```
  58. The first tool call after login starts a Chromium browser; the first run may download it.
  59. ## Pacing
  60. An assistant that researches on its own can issue many calls in a row. Each one loads real LinkedIn pages, and bursts are what get accounts throttled. This server spaces calls out. It only ever delays a call, never refuses or retries one.
  61. | Variable | Default | Meaning |
  62. |----------|---------|---------|
  63. | `LINKEDIN_MIN_CALL_GAP_SECONDS` | `3` | Minimum quiet gap between the end of one call and the start of the next. |
  64. | `LINKEDIN_CALL_GAP_JITTER_SECONDS` | `1.5` | Random extra added to that gap, so the rhythm is not machine-regular. |
  65. | `LINKEDIN_MAX_CALLS_PER_MINUTE` | `12` | Ceiling on calls per rolling minute. `0` turns the ceiling off. |
  66. Set the first two to `0` and the third to `0` to switch pacing off entirely. Other settings (headless mode, timeouts, log level, profile directory) are listed in [`.env.example`](.env.example) and in `linkedin-scraper-mcp --help`.
  67. ## What changed from the original
  68. - **Read-only.** The code for these tools was deleted, not disabled: sending and replying to messages, connection requests, archiving conversations, dismissing jobs, opening Easy Apply forms, and reading your inbox, conversations, feed, post search and sidebar suggestions.
  69. - **No outbound calls except to LinkedIn.** The original contacted `mcp.daniel.sticker.name` at every start (sending version, OS, architecture, language and the name of your MCP client) and accepted remotely served tools whose calls were posted back to that server. It also checked PyPI for updates and searched GitHub issues with your error text. All of that is removed. Browser installation still downloads Chromium from its official source.
  70. - **Pacing** as described above.
  71. - **Renamed**: package `linkedin_scraper_mcp`, command `linkedin-scraper-mcp`, state in `~/.linkedin-scraper-mcp`. It does not share a login or state with the original, and the two can be installed side by side.
  72. - **Trimmed** the original's release, CI, Docker and marketplace-plugin machinery, which does not apply here.
  73. ## Responsible use
  74. Automating LinkedIn through a browser is against LinkedIn's terms of use, and it can get your account limited or banned. You use this software at your own risk. Keep volumes low, keep pacing on, use it on your own account for your own research, and respect other people's privacy and applicable law (for example GDPR and LGPD when you handle personal data).
  75. ## Development
  76. ```bash
  77. uv sync --group dev
  78. uv run ruff check .
  79. uv run pytest
  80. uv run linkedin-scraper-mcp --no-headless # run locally with a visible browser
  81. ```
  82. ## License
  83. Apache License 2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
  84. Original work Copyright 2025-2026 Daniel Sticker. Modifications Copyright 2026 Gustavo Guaitolini.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.