linkedin-scraper-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@linkedin-scraper-mcp Look up Jane Doe's LinkedIn profile and summarize her experience"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
linkedin-scraper-mcp
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.
Independent open-source project. Not affiliated with, endorsed by or sponsored by LinkedIn or Microsoft. LinkedIn is a trademark of LinkedIn Corporation.
This is a modified version of linkedin-mcp-server by Daniel Sticker, used under the Apache License 2.0. See What changed and NOTICE.
Tools
All 13 tools only read.
Tool | Description |
| Read profile sections: experience, education, skills, projects, volunteering, posts. |
| Read your own profile, with the same section selection. |
| Find people by keyword, location, degree, company and mutual connections. |
| Read company information, with optional sections for posts and open jobs. |
| Read recent posts from a company's feed, with links to the originals. |
| Find company employees, optionally filtered by name, title or skill. |
| Find companies by keyword and return links to their profiles. |
| Find job postings by keyword and location, with job IDs for details. |
| Read a posting's description, requirements and company details. |
| Check whether a job uses Easy Apply or links to the employer's application. |
| List your saved job postings. |
| Check your saved login and browser state without opening a browser. |
| Close the shared browser without deleting your saved login. |
Related MCP server: linkedin-mcp-server
Install
Requires uv and Python 3.12 or newer.
uv tool install git+https://github.com/Guaitolinii/linkedin-scraper-mcpor, from a local checkout:
uv tool install .Do not run
uvx linkedin-scraper-mcp. That name on PyPI belongs to a different, unrelated package, anduvxwould 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>Log in
linkedin-scraper-mcp --loginA 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.
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.
To forget the session: linkedin-scraper-mcp --logout.
Use it from an MCP client
Claude Code:
claude mcp add linkedin -- linkedin-scraper-mcpAny client that takes a JSON config:
{
"mcpServers": {
"linkedin": {
"command": "linkedin-scraper-mcp"
}
}
}The first tool call after login starts a Chromium browser; the first run may download it.
Pacing
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.
Variable | Default | Meaning |
|
| Minimum quiet gap between the end of one call and the start of the next. |
|
| Random extra added to that gap, so the rhythm is not machine-regular. |
|
| Ceiling on calls per rolling minute. |
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 and in linkedin-scraper-mcp --help.
What changed from the original
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.
No outbound calls except to LinkedIn. The original contacted
mcp.daniel.sticker.nameat 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.Pacing as described above.
Renamed: package
linkedin_scraper_mcp, commandlinkedin-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.Trimmed the original's release, CI, Docker and marketplace-plugin machinery, which does not apply here.
Responsible use
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).
Development
uv sync --group dev
uv run ruff check .
uv run pytest
uv run linkedin-scraper-mcp --no-headless # run locally with a visible browserLicense
Apache License 2.0. See LICENSE and NOTICE. Original work Copyright 2025-2026 Daniel Sticker. Modifications Copyright 2026 Gustavo Guaitolini.
Available Tools
13 toolsclose_sessionClose SessionADestructive
Close the current browser session and clean up resources.
Inputs: no named parameters. Returns: object
get_company_employeesGet Company EmployeesARead-only
List employees at a company from the LinkedIn /people/ page, including the demographics aggregate that this view exposes: where employees live, where they studied, and a function breakdown (Engineering, Sales, Operations, etc.). The demographics are unique to this tool.
For filtered search by network degree (1st/2nd/3rd) or location, prefer search_people with current_company set to the company URN id. That path also returns more result pages than the /people/ tab.
The optional keywords filter narrows results by name, title, or skill.
company_name must be the exact LinkedIn URL slug (the path segment after /company/), not the display name. LinkedIn assigns unique slugs and the display name often does not match. For example, the AI lab Anthropic lives at /company/anthropicresearch/, not /company/anthropic/. If you are unsure of the slug, call search_companies first and pick the slug from the returned references.
Inputs: company_name (required), keywords. Returns: object
get_company_postsGet Company PostsCRead-only
Get recent posts from a company's LinkedIn feed.
Inputs: company_name (required), max_scrolls. Returns: object
get_company_profileGet Company ProfileCRead-only
Get a specific company's LinkedIn profile.
Inputs: company_name (required), sections. Returns: object
get_job_apply_urlGet Job Apply URLARead-only
Get how a job posting takes applications, and the employer's application link.
Reads the posting without clicking anything.
Inputs: job_id (required). Returns: object
get_job_detailsGet Job DetailsARead-only
Get job details for a specific job posting on LinkedIn.
Inputs: job_id (required). Returns: object
get_my_profileGet My ProfileARead-only
Get the authenticated user's own LinkedIn profile.
Navigates to /in/me/ and resolves the redirect to obtain the real username before reading the profile, so the url field in the result is the actual profile URL (e.g. linkedin.com/in/johndoe/) rather than /in/me/.
Inputs: sections, max_scrolls. Returns: object
get_person_profileGet Person ProfileCRead-only
Get a specific person's LinkedIn profile.
Inputs: linkedin_username (required), sections, max_scrolls. Returns: object
get_saved_jobsGet Saved JobsARead-only
List the authenticated user's jobs at one stage of LinkedIn's job tracker.
Returns job_ids that can be passed to get_job_details for full info.
Inputs: stage, max_pages. Returns: object
get_session_statusGet Session StatusARead-only
Report local saved-session and serving-process state for requested diagnostics.
Reads local observations without opening a browser, starting setup or login, or contacting LinkedIn. Stored files do not prove current authentication. In shared-browser mode these observations belong to the owner, not to a frontend running a login. It answers during browser work without refreshing the browser idle timer. Use ordinary LinkedIn tools directly for their requested work rather than adding a status preflight.
Inputs: no named parameters. Returns: object
search_companiesSearch CompaniesBRead-only
Search for companies on LinkedIn.
Inputs: keywords (required). Returns: object
search_jobsSearch JobsARead-only
Search for jobs on LinkedIn.
Returns job_ids that can be passed to get_job_details for full info.
LinkedIn is moving accounts to a redesigned job search, which keeps only the keywords, date_posted and paging. It drops the filters marked "Classic search only" and reports them in section_errors as filters_dropped. When it drops the location or work type, search again with them in the keywords ("remote python developer in Lyon") and keep doing so; words such as "senior" or "internship" there narrow the results too. Quotes do not make a phrase exact on that search.
Inputs: keywords (required), sort_by, job_type, location, +5 more. Returns: object
search_peopleSearch PeopleCRead-only
Search for people on LinkedIn.
Inputs: keywords (required), network, location, connection_of, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool maps to a distinct resource+action pair (person, company, job, session), and the overlapping edges are explicitly disambiguated in descriptions — get_company_employees tells you to prefer search_people for filtered searches, and get_my_profile is clearly separated from get_person_profile. get_job_apply_url vs get_job_details is also cleanly split by concern.
Uniform verb_noun snake_case throughout: get_*, search_*, close_session, get_session_status. No camelCase or stylistic drift.
13 tools covering four resource families (people, companies, jobs, session) is well-scoped, with each tool earning its place. No near-duplicate tools padding the set.
Covers search+detail for people, companies, and jobs plus session teardown and diagnostics, which is the core lifecycle for a scraper. Minor gaps: no session-open/login tool to pair with close_session, and no way to read a person's posts/activity or company job listings beyond the employee demographics view.
Maintenance
Related MCP Connectors
LinkedIn for AI agents: search people, read profiles, posts and connections via a connected account
LinkedIn jobs, companies and people for AI agents, plus messages and invites via your own account.
Give AI agents the LinkedIn tools to find, qualify, engage, and follow up with prospects.
Full LinkedIn access for AI agents: leads, messaging, and campaigns with activity limits built in.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to read LinkedIn profiles, company pages, jobs, messages, and feed through a user's logged-in browser session.19Apache 2.0
- AlicenseAqualityCmaintenanceEnables AI assistants to access LinkedIn data through the user's logged-in browser session, supporting profiles, companies, job searches, messaging, and feed/posts.21Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to use an existing browser session to read profiles and companies, search jobs and people, and manage messages and connection requests on LinkedIn.21Apache 2.0
- AlicenseAqualityBmaintenanceGives AI agents access to LinkedIn through your own browser session, enabling profile and company research, job searching, and management of conversations and connection requests.25Apache 2.0