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.
---
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).
---
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:
**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
Then point the config at this folder's dist/main.js instead:
---
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). |