jobspy-mcp

MCP server wrapping JobSpy to search LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google Jobs, Bayt, Naukri, and BDJobs from any MCP-compatible AI client.

Quick Start

Run directly with uvx (stdio, default):

uvx jobspy-mcp

Or with SSE / HTTP transports:

uvx jobspy-mcp --transport sse                        # SSE on 127.0.0.1:8000
uvx jobspy-mcp --transport streamable-http            # HTTP on 127.0.0.1:8000
uvx jobspy-mcp --transport sse --host 0.0.0.0 --port 9000

Or install globally:

pip install jobspy-mcp
jobspy-mcp

CLI Options

Flag Default Description
--transport stdio stdio, sse, or streamable-http
--host 127.0.0.1 Bind host (SSE/HTTP only)
--port 8000 Bind port (SSE/HTTP only)

Claude Desktop Configuration

Add to ~/.config/claude/claude_desktop_config.json (Linux/macOS):

{
  "mcpServers": {
    "jobspy": {
      "command": "uvx",
      "args": ["jobspy-mcp"]
    }
  }
}

On Windows: %APPDATA%\Claude\claude_desktop_config.json

Available Tools

Tool Description
list_job_sites Returns all supported site names with notes
search_jobs Search jobs with full parameter control

search_jobs Parameters

Parameter Type Default Description
site_name list[str] ["linkedin","indeed"] Job boards to search
search_term str None Job title or keywords
google_search_term str None Search term for Google Jobs specifically
location str None City, state, or country
results_wanted int 15 Results per site
hours_old int None Filter by recency (hours)
job_type str None fulltime, parttime, internship, contract
is_remote bool False Remote jobs only
distance int 50 Search radius in miles
country_indeed str "usa" Country for Indeed/Glassdoor
easy_apply bool None Easy Apply filter
linkedin_fetch_description bool False Fetch full LinkedIn descriptions
offset int 0 Pagination offset
description_format str "markdown" "markdown" or "html"
proxies list[str] None Proxy URLs for rate limit avoidance

Supported Sites

Site Notes
linkedin Global; proxies recommended for large searches
indeed Best scraper; use country_indeed for non-US
glassdoor Use country_indeed for non-US
zip_recruiter US and Canada only
google Use google_search_term for best results
bayt Middle East focused
naukri India focused
bdjobs Bangladesh focused

Development

git clone https://github.com/andrijdavid/jobspy-mcp
cd jobspy-mcp
uv sync --dev
uv run pytest
uv run jobspy-mcp   # starts MCP server on stdio

Project links

Data verified by PyPI on Aug 17, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for andrijdavid from gravatar.com andrijdavid

Credits

Author: Andrij David

GitHub Statistics

Data verified by PyPI on Aug 17, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU Affero General Public License v3 (AGPL-3.0-or-later)

Requires

Python >=3.10

Tags

glassdoor indeed job-search jobspy linkedin mcp

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jobspy_mcp-0.1.1.tar.gz (95.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jobspy_mcp-0.1.1-py3-none-any.whl (18.1 kB view details)

Uploaded Python 3

File details

Details for the file jobspy_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: jobspy_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 95.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for jobspy_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 303df440097cdef2981c420b122089d8623a4d004f8ea3428f1789f5aed025dd
MD5 7daa7b1cc299a87ab3f2601365a91cda
BLAKE2b-256 77007a117947a62dbf4fff4c4d6cfa8ac545b008e03e79f4df7a427885ef0187

See more details on using hashes here.

Provenance

The following attestation bundles were made for jobspy_mcp-0.1.1.tar.gz:

Publisher: publish.yml on andrijdavid/jobspy-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file jobspy_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: jobspy_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 18.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for jobspy_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 44d870c3a5dd7244e99bdf09a52c9d0b316930f1d4077082fe46aea8fb0c80f4
MD5 de3b50fb207c251cb17a85ea2fd91909
BLAKE2b-256 c4350a4568f732284f1622689faa4b423fab05dd5119893896110283b4b0b58f

See more details on using hashes here.

Provenance

The following attestation bundles were made for jobspy_mcp-0.1.1-py3-none-any.whl:

Publisher: publish.yml on andrijdavid/jobspy-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page