JobSpy MCP Server: Search LinkedIn and Indeed Jobs from Claude
Lets Claude and Cursor search job boards such as LinkedIn and Indeed and pull full job details, from your own computer.
JobSpy's MCP server lets Claude, Cursor and other assistants search LinkedIn, Indeed, Glassdoor, ZipRecruiter and four regional job boards from one prompt. It is the JobSpy project's own server and runs on your computer with no account or API key. Job boards often block repeated searches, so the README suggests a proxy if searches fail. The assistant can also save results to a file on your machine.
Good for
- Job seekers who want an assistant to search several boards at once
- Recruiters and analysts who need job listings in a CSV or JSON file
- Developers who already use the JobSpy Python library
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install JobSpy MCP
Claude Code
- 1
Copy this prompt.
Add the JobSpy MCP server to Claude Code. Run this command: claude mcp add jobspy -- uvx mcp-jobspy Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python).
Built from the package data we hold. Not yet tested by us.
Tools
Searches job boards and returns a preview of each job
Searches LinkedIn, Indeed, ZipRecruiter, Glassdoor and four regional boards in one go. It returns up to 25 short previews per board plus a search ID, and can save the full results to a CSV, JSON or JSONL file on your machine. You can filter by keywords, place, remote, job type, posting age and proxy.
Try: “Find remote data analyst jobs posted in the last 48 hours on Indeed and LinkedIn.”
Write ·
search_jobsShows the full record for jobs from a search
Returns the full records of up to five jobs from an earlier search, including description, emails, skills and company details, without searching again. Results are kept only for the current server session, the last 20 searches.
Try: “Show me the full description for the first two jobs from that search.”
Read ·
get_job_details
Read from the source code
Permissions
medium risk · 3 things to watch
Medium risk
It reads public job boards through your internet connection and can write search results to any .csv, .json or .jsonl path you or the assistant give it. Approve file saves yourself and keep proxy passwords out of the chat.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can overwrite files you name
The save option writes search results to a path the assistant picks, as long as it ends in .csv, .json or .jsonl, and replaces any file already there. Check the path before you approve it. github.com
Job boards may block or limit you
The tool description says the boards often fail without a proxy and block repeated searches. Ask each board for only the number of results you need. github.com
Job text is untrusted
Listings come from the boards and could contain text that tries to steer the assistant. The server reminds the model not to treat it as instructions. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only switch is documented. Only search_jobs can write a file, and only when save_to is set. |
|---|---|
| Talks to | Your search terms, location and filters, sent to each job board you search (LinkedIn, Indeed, Glassdoor, ZipRecruiter, Bayt, Naukri, BDJobs, HelloWork). Any proxy you configure, which sees those requests |
| Sign-in and keys | No account or API key. An optional proxy URL can carry a username and password, which the README suggests keeping in the HTTPS_PROXY setting. |
Questions
Is this the official LinkedIn or Indeed server?
No. It is made by the JobSpy project, which scrapes the public job boards. LinkedIn, Indeed and the other boards do not publish it.
Does it need an API key or account?
No. It runs on your computer and reads the public boards. A proxy is optional and set with the HTTPS_PROXY setting or passed in a search.
Which job boards does it search?
LinkedIn, Indeed, Glassdoor, ZipRecruiter, Bayt, Naukri, BDJobs and HelloWork. By default it searches the main boards and you can name others in your prompt.
Why do my searches fail or come back empty?
Job boards often block repeated searches, and the tool says so. Add a proxy and ask for the number of results you need from each board. An empty list can also mean no matches.
Can it save results to a file?
Yes. A search can save every record to a .csv, .json or .jsonl file on your computer. Without that option nothing is written.
How do I add it to Claude Code or Cursor?
Use the install box above. It needs uv installed. The README config writes mcp-jobspy@latest, which asks uv for the newest release each time; the commands in the install box use plain mcp-jobspy.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
mcp-jobspy- Registry
- PyPI
- Transport
- stdio
- Auth
- None
- Version
- 1.4.1
- License
- MIT
- Last commit
- Oct 27, 2026
- Open issues
- 16
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- mcp-jobspy README · github.com
- mcp.py · github.com