Skip to main content
Glama
job-search-mcp

job-search-mcp

by Servation

job-search-mcp

A personal job-search assistant for Claude Desktop. You ask Claude to find jobs; it searches the real job boards, scores each one 0–100 for how well it fits you, and shows them on a ranked board you can triage with one click. Everything runs locally — no API keys, no accounts required.

It's an MCP App: a small server Claude Desktop talks to, plus an inline board that renders right in the chat.

Scope: it's tuned for US software-engineering roles (the built-in sources and role filters target US tech employers). Other fields or regions will return sparse results.

Works in: built and tested for Claude Desktop. It should also work in other MCP clients that both run a local (stdio) server and render MCP App UIs, such as VS Code (Copilot), Cursor, or Goose (untested). Remote-only clients (ChatGPT, Claude on web/mobile) can't launch a local server, so they won't work.

The ranked job board inside Claude Desktop — each job scored 0–100 for fit, with Applied/Skip buttons


What it does

  • Searches real job boards — LinkedIn plus 8 ATS/job sources (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Hacker News, RemoteOK, Remotive), using your target roles and location.

  • Scores each job for you — Claude reads the full description and gives it a 0–100 fit score with a one-line reason, weighing your skills, years of experience, seniority fit, and the role.

  • Lets you triage fast — Apply / Skip on each card, or in bulk ("dismiss everything under 60").

  • Remembers — keeps a running shortlist, a tracker of what you've applied to, and won't show you the same job twice (for 6 months).


Related MCP server: Jobless MCP

Setup

1. Tell Claude Desktop about it. Open your config file:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add this under "mcpServers" — npx fetches the published package for you, no cloning or building required:

{
  "mcpServers": {
    "job-search": {
      "command": "npx",
      "args": ["-y", "@servation/job-search-mcp"]
    }
  }
}

2. Fully quit and reopen Claude Desktop (on Windows, quit it from the system tray — closing the window isn't enough). That's it.

npm install
npm run build

Then point the config at this folder's dist/main.js instead:

{
  "mcpServers": {
    "job-search": {
      "command": "node",
      "args": ["D:\\job-search-mcp\\dist\\main.js"]
    }
  }
}

How to use it

Just talk to Claude. For example:

  • "Save my profile" — paste your resume first; Claude pulls out your skills, roles, years, and location so searches and scoring are tailored to you.

  • "Find backend engineer jobs in California, senior level, posted this week."

  • "Find low-applicant jobs" — adds LinkedIn's early-applicant filter.

  • "Dismiss everything under 60."

  • "Show what I've applied to."

  • "Re-score the board."

A typical first run: save your profile → "find jobs" → Claude scores them and shows the ranked board → you Apply/Skip.


The board

The board is a running shortlist. A job stays on it until you Apply (moves to your tracker) or Skip (hidden for good). New searches automatically skip jobs already on the board, in your tracker, dismissed, or shown in the last 6 months — so you never see the same listing twice in a row.

Click Applied or Skip on a card, or ask Claude to do it. Triaged in the widget, it sticks.


Tools (for reference)

You rarely call these by name — Claude picks the right one — but here's what's under the hood:

Tool

What it does

find_jobs

Search the boards for your roles/location (with optional filters: seniority, type, recency, remote, salary, applicants, source).

evaluate_jobs

Claude scores the found jobs 0–100 for fit (runs automatically after a search).

show_board

Display the ranked board (or your saved tracker).

set_status

Apply / Skip / save a single job (also the card buttons).

bulk_status

Triage many at once by score or source, e.g. dismiss everything under 60.

whats_promising

List the current board as text (all scored jobs + anything still unscored).

review_saved

Your tracker — jobs you've saved or applied to.

rescore_board

Re-score every job on the board from scratch.

clear_jobs

Declutter: clear unscored leftovers or the whole board (never touches applied/dismissed).

save_profile

Save your resume profile (drives search + scoring).


Where your data lives

One JSON file on your machine — no cloud, nothing sent anywhere except the job boards you search:

  • Installed: ~/.job-search-mcp/jobs.json

  • Running from source: ./data/jobs.json

  • Override with the JOB_SEARCH_MCP_DATA environment variable.


Optional: LinkedIn Premium mode

By default LinkedIn uses its public guest endpoints: no login and no account-login risk, and you already get full job descriptions. Note that automated access still runs from your own IP and is against LinkedIn's User Agreement even in guest mode, so use it at your discretion. If you want richer/Premium data, you can use your logged-in account by adding an env block to the server config:

"job-search": {
  "command": "npx",
  "args": ["-y", "@servation/job-search-mcp"],
  "env": {
    "LINKEDIN_LI_AT": "<your li_at cookie>",
    "LINKEDIN_JSESSIONID": "ajax:1234567890123456789"
  }
}

Get both cookies from a logged-in linkedin.com tab → DevTools → Application → Cookies.

⚠️ Heads up: this is against LinkedIn's Terms of Service and can get your account flagged or restricted. The cookies also expire about monthly and LinkedIn's internal endpoints change without notice. If anything fails it falls back to guest mode automatically. Leave the env block out to stay fully safe (guest-only).


How scoring works

Claude (the host model) does the scoring directly — it reads each description and judges fit, which is well-calibrated. A deterministic formula (computeMatchScore in scoring.ts) is kept as a fallback for anyone running a weaker local model that tends to over-rank everything; it's not active by default.

Development

npm run typecheck    # type-check UI + server + harness
npm run build        # build the UI bundle (vite single-file) + compile the server (tsc)
npm run serve:stdio  # run the server from source (tsx) for local testing
npm run harness      # work on the review UI without Claude Desktop (see harness/)
npm run canary       # check every job source is still returning postings

The server is stdio-only (main.ts → server.ts); the UI is a React app bundled to a single inlined HTML file (src/mcp-app.tsx → dist/mcp-app.html) that the server serves as a ui:// resource.

Working on the UI, use harness/. It is a local stand-in for Claude Desktop that renders the widget against a synthetic job store and a real ui/* bridge. Opening dist/mcp-app.html in a browser tab just gets you "Connecting…", and the things most likely to break (link opening, theming, the post-mount refresh) are all host-mediated, so they only show up with a host on the other end.

If a job source goes dark, npm run canary tells you which one. Company slugs rot often, so the fix usually belongs in the remote slug registry that updateCompanyDirectoriesFromRegistry() re-reads at runtime, rather than in a new release.

Available Tools

10 tools
bulk_statusBulk TriageA

Triage MANY board jobs at once by score and/or source — e.g. dismiss every scored job under 60. Applies status to all scanned (board) jobs matching the filters; the server selects them, so you do NOT need the individual job ids. below_score/above_score match SCORED jobs only (use clear_jobs for un-evaluated ones). Provide at least one filter. Returns text; call show_board afterward to display.

Inputs: status (required), notes, source, above_score, +1 more.

clear_jobsClear JobsA

Clear jobs from the review board. which='unscored' (default) removes only the not-yet-evaluated leftovers; which='all' clears the whole board. Saved/applied jobs (the tracker) and dismissed jobs are NOT affected — dismissed jobs still won't be re-sourced. Returns text; call show_board to display.

Inputs: which.

evaluate_jobsEvaluate JobsA

Score one or more sourced jobs for THIS candidate (holistic). YOU assign each job a 0-100 fit score directly, using the candidate summary (shown in find_jobs / whats_promising) and the job description. Weigh the must-have requirements, the candidate's actual skills and years of experience (a role demanding far more seniority/years than the candidate has should score LOWER), domain fit, and standout strengths. Calibrate and use the FULL range — do not bunch everything at 80+: 80-100 = strong fit and realistic; 60-79 = good with real gaps; 40-59 = partial/stretch (e.g. wrong level); below 40 = poor or wrong field. Pass { job_id, score, reason } per job. Use the EXACT bracketed ids; do not invent them. Score every job in one call. Returns text; call show_board afterward to display the ranked board.

Inputs: evaluations (required).

find_jobsFind JobsA

Source live jobs (LinkedIn + Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Hacker News, RemoteOK, Remotive), dedup them, and return them as text with full descriptions. Uses the saved profile's roles/location by default; pass query/location/filters to override. This returns UNSCORED jobs and does NOT show a card UI — immediately score all of them with evaluate_jobs (a 0-100 fit score + reason each), then show_board once, to present the single ranked board. Do not just list them back.

Inputs: limit, query, remote, sort_by, +9 more.

rescore_boardRe-score BoardA

Re-score the WHOLE board from scratch — every job, INCLUDING ones that already have a score. Use this when the user asks to 'rescore'/'re-evaluate' the board or after the scoring approach changed. Returns all board jobs with their ids + descriptions; call evaluate_jobs with a FRESH { job_id, score, reason } for EACH (do not skip already-scored ones), then call show_board. Set include_saved=true to also re-score the saved/applied tracker.

Inputs: include_saved.

review_savedReview Saved JobsA

List the tracker as text: jobs marked saved (interested) or applied, with their status, score, and notes. Use this to see what you're tracking or have applied to. To DISPLAY the tracker widget, call show_board with view='saved'.

Inputs: no named parameters.

save_profileSave Resume ProfileA

Extract the candidate's profile from their resume text (which the user pastes in chat) and save it. Pull: full name; core technical skills; suggested target roles; preferred/search location; total years of professional experience (integer); and pass the resume text as rawText. The profile is used by find_jobs (target roles + location) and by scoring (years of experience drives the experience penalty), so set yearsOfExperience accurately. Merges with any existing profile.

Inputs: name, skills, rawText, targetRoles, +4 more.

set_statusSet Job StatusA

Triage a job by id: 'saved' (interested/tracking), 'applied' (also stamps the date), 'dismissed' (skip), or 'discovered' (undo back to the board). Moves it between the scanned/saved/dismissed lists and persists. Optionally attach notes. Called by the review UI; also usable directly.

Inputs: job_id (required), status (required), notes. Returns: jobs, view, count, scored, +1 more

show_boardShow BoardA

Display the job board (or the saved/applied tracker) as an interactive widget. Call this ONCE, at the end of a request, after doing the work (find_jobs/evaluate_jobs/bulk_status/clear_jobs/whats_promising are text-only and do NOT render). view='board' (default) shows the ranked board; view='saved' shows the tracker.

Inputs: view. Returns: jobs, view, count, scored, +1 more

whats_promisingWhat's PromisingA

List the current job board as text: every scored job (with its id) and any UNSCORED jobs with their ids + descriptions so you can evaluate them. To score the unscored ones, call evaluate_jobs with the EXACT bracketed ids shown. Use this to review jobs already found (find_jobs only returns brand-new ones). To re-score jobs that ALREADY have a score, use rescore_board instead. To DISPLAY the board widget to the user, call show_board (this returns text for you to act on).

Inputs: limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: bulk_status for bulk triage, clear_jobs for clearing, evaluate_jobs for scoring single jobs, find_jobs for sourcing, rescore_board for re-evaluating all, review_saved for tracker text, save_profile for profile, set_status for individual triage, show_board for display, and whats_promising for listing. No overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., bulk_status, evaluate_jobs, save_profile). The only minor deviation is 'whats_promising' using a contraction, but it still follows the pattern and is easily readable.

    Tool Count5/5

    10 tools is well within the ideal 3-15 range for a focused job search server. Each tool addresses a necessary function without bloat, and the count feels natural for the domain.

    Completeness4/5

    The tool set covers the core workflow: sourcing (find_jobs), scoring (evaluate_jobs, rescore_board), triaging (bulk_status, set_status, clear_jobs), tracking (review_saved), display (show_board), and profile management (save_profile). Minor gaps like no explicit profile update tool exist, but save_profile merges, so it's almost complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables job search and scraping across multiple job boards (LinkedIn, Indeed, Glassdoor, etc.) with advanced filtering, directly from Claude Desktop or other MCP clients.
      6
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Personalized job search inside Claude. Get ranked job matches based on your actual skills, not keywords.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Transforms Claude into an AI job-hunting assistant that searches remote job boards, scores roles against your CV, generates tailored cover letters, and logs everything to a Notion tracker.
      11
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and evaluating job postings from LinkedIn and freehire.me directly through Claude Desktop. Provides tools to search jobs, fetch full posting details, and assess candidate fit using eligibility scans and a scoring rubric.
      MIT