Happy slice of mcp pizzaMCP.pizza

jobspy-mcp-server

MCP.Pizza Chef: borgius

This lets an assistant such as Claude run one job hunt across Indeed, LinkedIn, ZipRecruiter, Glassdoor, Google, Bayt and Naukri together, then hand the listings back in a form you can sort or open in a spreadsheet. You say the job title, the city, how recent a posting has to be and how many results you want. Setup is hands-on: you download the project, install its Node and Python parts, then paste a short snippet into Claude Desktop.

Data
Web/Research

Use This MCP server To

Find remote jobs posted in the last day Compare listings for one role across several job sites Pull senior engineer roles in a specific city Save a batch of job listings as a spreadsheet Ask for only postings from the last 24 hours Summarize what a set of listings has in common

README

JobSpy MCP Server

A Model Context Protocol (MCP) server that enables AI assistants like Claude to search for jobs across multiple job listing platforms using the JobSpy tool.

Features

  • Search for jobs across multiple platforms (Indeed, LinkedIn, Glassdoor, etc.)
  • Filter by search terms, location, time frames, and more
  • Get structured job data that AI models can easily process
  • Format results as JSON or CSV
  • Multiple transport options: stdio for Claude integration, SSE for web clients

Prerequisites

  • Node.js 16+
  • Python 3.6+
  • The JobSpy tool installed and available

Installation

# Clone the repository
git clone https://github.com/borgius/jobspy-mcp-server.git
cd jobspy-mcp-server

# Install dependencies
npm install

# Make sure the JobSpy tool is properly set up
cd ../jobSpy
pip install -r requirements.txt
chmod +x run.sh

Configuration

The server will automatically try to locate the JobSpy script in standard locations:

  • ../jobSpy/run.sh (relative to the server directory)
  • ./run.sh (in the current directory)
  • /app/run.sh (for Docker environments)

Environment Variables

You can configure the server using the following environment variables:

Environment Variable Description Default
JOBSPY_DOCKER_IMAGE Docker image to use for JobSpy jobspy
JOBSPY_ACCESS_TOKEN Access token for JobSpy API (if required) none
PORT Port for the MCP server 9423
HOST Host for HTTP server '0.0.0.0'
ENABLE_SSE Enable Server-Sent Events transport 0

jobspy-mcp-server FAQ

Which job sites does it cover?
Indeed, LinkedIn, ZipRecruiter, Glassdoor, Google, Bayt and Naukri, one at a time or several at once.
Which apps can use it?
Claude Desktop through a small settings snippet, and web apps through its live-updates connection.
Do I need a paid key?
Usually not — extra credentials are only needed if your own JobSpy setup asks for them.
Can I use this to find jobs posted in the last 24 hours?
Yes — you choose how many hours old listings may be, and 72 hours is the default.
How hard is setup?
Hands-on: download the project, install the Node and Python parts, then paste a short snippet into Claude Desktop.
Can I get the results as a spreadsheet?
Yes — ask for CSV output and it opens straight in Excel or Google Sheets.