JobSpy MCP Server

An implementation of the Model Context Protocol (MCP) that integrates the python-jobspy library. This server allows AI models like Claude to perform real-time, aggregated job searches across LinkedIn, Indeed, ZipRecruiter, and Glassdoor directly from the chat interface.

Features

Aggregated Search: Query multiple job boards simultaneously with a single command.
Advanced Filtering: Support for job_type (contract, full-time, etc.), is_remote, and distance.
Intelligent Salary Filter: A local processing layer that filters results to only show jobs meeting your min_salary requirement.
Markdown Summaries: Use the jobs://latest-summary resource to view your most recent search results in a clean, human-readable table.
JSON Serialization Fix: Properly handles Python date objects to prevent "Object of type date is not JSON serializable" errors.

Installation

1. Clone the Repository

git clone [https://github.com/YOUR_USERNAME/jobspy_mcp_server.git](https://github.com/YOUR_USERNAME/jobspy_mcp_server.git)
cd jobspy_mcp_server

2. Install Dependencies

Ensure you are using Python 3.10 or higher.

pip install mcp python-jobspy pandas tabulate

Configuration for Claude Desktop

To use this server, add it to your claude_desktop_config.json.

File Locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Config Entry:

{
  "mcpServers": {
    "jobspy-pro": {
      "command": "python",
      "args": ["/home/lowcoordination/DataspellProjects/jobspy_mcp_server/job_server.py"]
    }
  }
}

(Note: Ensure the absolute path in the args section matches your local environment.)

Usage

Once the server is connected (look for the 🔌 icon in Claude), you can use prompts like:

"Find me remote Information Security GRC roles paying at least $130,000."
"Search for 6-month contracts for Cybersecurity Engineers near Indianapolis."
"What are the latest job postings for IT Security Consultants in the last 24 hours?"

License

This project is licensed under the MIT License. It is a wrapper designed for the Model Context Protocol and utilizes the MIT-licensed python-jobspy library.

MCP Servers