job-search-mcp
About
Claude Desktop job search assistant: searches LinkedIn + 8 ATS boards, scores each job 0-100 for fit, and shows a ranked board to triage.
Details
- Author
- servation
- Categories
- Productivity, Other, AI, Search, Knowledge Base
Jump to
Setup
Install job-search-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/servation/job-search-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A personal job-search assistant forClaude 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.
Scope:it's tuned forUS 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 forClaude Desktop. It should also work in other MCP clients that both run a local (stdio) serverandrender 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.
- 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 foryou— 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).
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"—npxfetches thepublished packagefor 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.
Then point the config at this folder'sdist/main.jsinstead:
{ "mcpServers": { "job-search": { "command": "node", "args": ["D:\\job-search-mcp\\dist\\main.js"] } } }
- "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 is arunning shortlist. A job stays on it until youApply(moves to your tracker) orSkip(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.
ClickAppliedorSkipon a card, or ask Claude to do it. Triaged in the widget, it sticks.
You rarely call these by name — Claude picks the right one — but here's what's under the hood:
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 theJOB_SEARCH_MCP_DATAenvironment variable.
By default LinkedIn uses itspublic guestendpoints: 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 anenvblock to the server config:
Claude (the host model) does the scoring directly — it reads each description and judges fit, which is well-calibrated. A deterministic formula (computeMatchScoreinscoring.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.
npm run typecheck # type-check UI + server 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
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 aui://resource.
A memory management server for Claude apps with optional AI-powered search, using local SQLite storage.
X (Twitter) bookmarks MCP server: search, label, and manage your saved posts from Claude, ChatGPT, Cursor, or any MCP client.
Eagle MCP Server is a local Model Context Protocol bridge that lets AI assistants (e.g. Cursor, Claude) access your Eagle media library so you can tag, categorize, search, and batch-organize assets with natural language.
A context insertion and search server for Claude Desktop and Cursor IDE, using configurable API endpoints.
MCP server for Anthropic Claude Messages API — chat, vision, web search, extended thinking (Rust)
Manage and coordinate multiple Xcode/Swift projects with features like project tracking, smart search, and analytics.
Provides web search functionality powered by the Claude API from Anthropic.
Connect Claude, ChatGPT, Grok or Cursor to 27.6 crore Indian court case records, orders, judgments and cause lists.
e-Gov法令API v2 をラップした Model Context Protocol (MCP) サーバーです。日本の法令データ(法令一覧・改正履歴・法令本文・添付ファイルなど)をMCP対応クライアント(Claude Codeなど)から検索・取得できるようにします。
Server that connects Claude/Cursor to the FatSecret Platform API. Search foods, track your diet, manage recipes, and monitor weight directly from your AI assistant.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





