Job Search MCP server

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.

What it does

SmartRecruiters, Hacker News, RemoteOK, Remotive), using your target roles and location.

• Searches real job boards — LinkedIn plus 8 ATS/job sources (Greenhouse, Lever, Ashby, Workday,

a one-line reason, weighing your skills, years of experience, seniority fit, and the role.

• Scores each job for you*** — Claude reads the full description and gives it a 0–100 fit score with

the same job twice (for 6 months).

• 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

Setup

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

• Windows: %APPDATA%\Claude\claudedesktopconfig.json
• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.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.

Running from source instead

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:

location so searches and scoring are tailored to you.

• "Save my profile" — paste your resume first; Claude pulls out your skills, roles, years, and

• "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:

Shortened. The full README is on GitHub.