linkedin-jobs-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
linkedin-jobs-mcp
Read-only MCP server for LinkedIn job hunting: search, full postings, jobs posted in the last minutes, saved searches that only report what is new, and a visa-sponsorship check on each ad.
Login works like familysearch-mcp: a browser window opens, you sign in by hand, and the session is stored on your machine. Job functions and safety rules are adapted from eliasbiondo/linkedin-mcp-server.
Tools
Tool | What it does |
| Opens Brave/Chrome with a separate profile; you log in; cookies go to |
| Check or delete the saved session. |
| Filters: |
| Description, criteria, applicants, |
| Jobs posted in the last N minutes (default 60) for up to 5 keyword sets at once, newest first, each flagged |
| Keep up to 30 named searches. |
| Who you are: seniority, years, skills, languages with CEFR level, whether you need a visa. Stored in |
| Fills the profile from the real thing. No arguments: reads your own LinkedIn profile through the saved session. With |
| Opens up to 10 postings and ranks them |
| Runs saved searches over the time since the last check and returns only jobs never seen before. |
Related MCP server: LinkedIn Job Scraper MCP Server
Profile and fit check
Run import-profile and the server builds the profile for you, or tell it by hand with set-profile, for example:
{ "seniority": "junior", "yearsExperience": 1, "skills": ["React", "TypeScript", "Node.js"],
"languages": { "en": "C1", "pt": "native", "de": "none" }, "needsVisa": true }Title filter. Your seniority picks the title words that get dropped from every search: a junior never sees "Senior", "Lead", "Staff" or "Werkstudent"; a senior never sees "Junior" or "Intern". Words are matched in EN, DE, NL, PT, FR and ES. Add your own with
excludeTitle, rescue words withincludeTitle, or passexcludeTitle: []on one call to switch it off.Fit check.
get-job-detailsandtriage-jobsread the ad and report:years of experience asked (
3+ years,≥ 3 Jahre,minimaal 2 jaar…) against yours;languages asked, with CEFR level (
Deutsch verhandlungssicher= C2), plus the language the ad is written in, against yours;visa: ads that rule it out (
work permit required,Arbeitserlaubnis … erforderlich) areblocked, ads that offer it are a plus, silence is flagged;which of your skills appear in the ad.
Importing the profile
import-profile(no arguments) reads the profile of the account that owns the saved login: jobs with dates, skills and languages. The account comes from LinkedIn's/me, never from an input, so it cannot read anybody else's profile. It uses LinkedIn's internal web API, which is undocumented and can change without notice, and reading it with your own session is a grey area of LinkedIn's terms: it is opt-in and only runs when you call it. If it comes back empty, use the text import.import-profilewithtexttakes a CV or the text of LinkedIn's "Save to PDF" and needs no login. Years of experience are the distinct months covered by your jobs (overlaps counted once; education, awards and future dates ignored), seniority comes from your current job title (or from the years if the title says nothing), skills come from the "Skills" section, and languages need an explicit level (English (C1),Portuguese (Native or Bilingual)) or they are skipped, never guessed.needsVisais never imported, a profile cannot know it: set it withset-profile.It saves by default and returns what it understood (
positions,notes). Passsave: falseto preview.
It is a heuristic from the ad text, not a verdict: read the blockers before trusting a blocked.
Search tips
keywords takes LinkedIn Boolean: AND, OR, NOT in uppercase, "straight quotes" for exact phrases and parentheses to group. Precedence is quotes > () > NOT > AND > OR, so always wrap OR lists in parentheses. Wildcards (*) and +/- are not supported. The server fixes curly quotes and lowercase operators on its own and reports what it changed in warnings.
Filters on search-jobs, fresh-jobs and save-search:
under10Applicants: LinkedIn's "Under 10 applicants" filter, for applying while you are still early.excludeTitle: drops jobs whose title has any of the given words, e.g.["manager", "sap"]. Without it, the words come from your profile. LinkedIn tends to ignoreNOTin complex queries, so this filter is the reliable way to exclude titles.
Visa: search for ("visa sponsorship" OR "relocation"), never the bare word "sponsorship". A keyword hit is not proof, so check visaMentions / visaNegatives in get-job-details.
Install
Claude Code (npx, no clone)
claude mcp add linkedin-jobs --scope user -- npx -y github:G4rutti/linkedin-jobs-mcpOptional login (needed only for the logged-in extras in get-job-details):
npx -y github:G4rutti/linkedin-jobs-mcp --loginThen run /mcp inside Claude Code to check it is connected. You can also call the login-with-browser tool from the chat.
Claude Desktop / Cursor / other MCP clients
{
"mcpServers": {
"linkedin-jobs": {
"command": "npx",
"args": ["-y", "github:G4rutti/linkedin-jobs-mcp"]
}
}
}From source
git clone https://github.com/G4rutti/linkedin-jobs-mcp && cd linkedin-jobs-mcp
npm install && npm run build
npm run login # optional
claude mcp add linkedin-jobs --scope user -- node "$(pwd)/build/index.js"Requirements: Node 18+. Playwright does not download a browser: login uses the Brave/Chrome you already have (LINKEDIN_BROWSER_PATH to override). The first npx run takes a bit longer because it installs and compiles the package.
Environment variables
Variable | Default | What it does |
|
| Minimum gap between requests (jitter is added on top). |
| auto | Browser used by the login. |
|
| Where the session and saved searches live. |
With Claude Code: claude mcp add linkedin-jobs --scope user -e LINKEDIN_MIN_INTERVAL_MS=6000 -- npx -y github:G4rutti/linkedin-jobs-mcp
Safety
Read-only. No apply, message, connect, save or post tools exist.
Search and job pages use LinkedIn's public endpoints without your cookies, so scraping is not tied to your account. The session is only used for the logged-in extras in
get-job-details.Cookies are only ever sent to
https://*.linkedin.com; redirects are checked hop by hop.~4 s between requests with jitter (
LINKEDIN_MIN_INTERVAL_MS). On HTTP 429/999 or a security checkpoint: no retry, 15-minute pause.Job ids are validated as digits before any request.
Details in AUDIT.md.
Using an automated client on LinkedIn is against its User Agreement and can get an account restricted. Use your judgement.
Tests
npm testLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
LinkedIn jobs, companies and people for AI agents, plus messages and invites via your own account.
LinkedIn jobs and company changes, Greenhouse, Lever, Ashby and 3 more ATS (unofficial, no login).
LinkedIn companies, hiring signals and public profiles by URL. No login, no cookies. Pay per result.
LinkedIn job listings as JSON: salary, recruiter, applicants, company data. No login. From $0.40/1k
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides tools for automating LinkedIn job post search and management. Job opportunities often appear in LinkedIn posts first, before they're posted on traditional job boards. By monitoring LinkedIn posts, you can discover opportunities earlier and get a competitive advantage in your job search.20 npm7ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, filter, and extract job listings from LinkedIn using an automated headless browser with semantic AI filtering and deduplication.28 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to read LinkedIn profiles, company pages, jobs, messages, and feed through a user's logged-in browser session.19Apache 2.0
- AlicenseNot gradedqualityCmaintenanceSearches LinkedIn for job posts, filters out non-vacancies and out-of-market roles, and provides a local dashboard to triage and rate the remaining openings.1ISC