The Google Jobs MCP Server enables comprehensive job search functionality via the SerpAPI with various filtering options and multi-language support:
Query-based searches: Search using keywords or job titles like 'software engineer'
Location filtering: Specify locations and search radius (e.g., '10mi')
Date filtering: Filter by posting date (today, last 3 days, last week, last month)
Job type filtering: Find full-time, part-time, contract, internship, or temporary positions
Salary filtering: Filter by salary range (e.g., '$100K+')
Multi-language support: Display results in English, Chinese, Japanese, or Korean
Sorting options: Sort by date, relevance, or salary
Pagination: Navigate through results (10 per page)
Provides Google Jobs search capabilities through SerpAPI integration, allowing users to search for job listings with various filters including job title, location, employment type, salary range, and more.
A Model Context Protocol (MCP) server implementation that provides Google Jobs search capabilities via SerpAPI integration. Features multi-language support, flexible search parameters, and smart error handling.
https://github.com/user-attachments/assets/8f6739e1-7db7-4171-88b4-59c6290a4c72
✨ Features
🌍 Multi-Language Support
Full localization support for English, Chinese, Japanese and Korean with automatic language detection and fallback.
🔍 Flexible Search Options
Comprehensive search parameters including:
Job title and keywords
Location with radius filtering
Employment type (full-time, part-time, etc.)
Salary range filters
Post date filtering
Results sorting
💡 Smart Error Handling
Comprehensive input validation
Helpful error messages and suggestions
Automatic search refinement suggestions
Rate limit handling
📊 Rich Job Details
Detailed job information formatting
Company benefits and highlights
Salary information when available
Direct application links
Job posting timestamps
🔄 Advanced Features
Pagination support
Multiple sorting options
Geographic radius search
Employment type filtering
🔑 SERP API Setup Guide
Before getting started, you'll need to obtain a SERP API key:
Visit SERP API website and create an account
After registration, go to your Dashboard:
Locate the "API Key" section
Copy your API key
New users get 100 free API calls
API Usage Details:
Free tier: 100 searches per month
Paid plans start at $50/month for 5000 searches
Billing based on successful API calls
Multiple payment methods: Credit Card, PayPal, etc.
Usage Limits:
Request Rate: 2 requests/second
IP Restrictions: None
Concurrent Requests: 5
Response Cache Time: 1 hour
👩🔧 Solution for MCP Servers Connection Issues with NVM/NPM
Click to view my configuration solution 👉 https://github.com/modelcontextprotocol/servers/issues/76
🚀 Quick Start
Install dependencies:
Configure environment: Modify your
claude_desktop_config.json
with the following content (adjust paths according to your system):
Build the server:
Start the server:
Troubleshooting
API Key Issues:
Verify key in configuration
Check key status in SERP API dashboard
Confirm key has remaining quota
Search Issues:
Validate search parameters format
Check network connectivity
Verify country/language code support
📦 Installation
Installing via Smithery
To install Google Jobs for Claude Desktop automatically via Smithery:
Manual Installation
@chanmeng666/google-jobs-server
Running evals
The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.
💻 Tech Stack
📖 API Documentation
The server implements the Model Context Protocol and exposes a job search tool with the following parameters:
query
: Search query string (required)location
: Job location (optional)posted_age
: Post date filter (optional)employment_type
: Job type filter (optional)salary
: Salary range filter (optional)radius
: Geographic search radius (optional)hl
: Language code (optional)page
: Pagination number (optional)sort_by
: Sort order (optional)
🔧 Development
📝 License
This project is MIT licensed.
🙋♀ Author
Created and maintained by Chan Meng.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that provides Google Jobs search capabilities through SerpAPI integration, featuring multi-language support, flexible search parameters, and rich job details.
- 🌍 Multi-Language Support
- 🔍 Flexible Search Options
- 💡 Smart Error Handling
- 📊 Rich Job Details
- 🔄 Advanced Features
- 🔑 SERP API Setup Guide
- 👩🔧 Solution for MCP Servers Connection Issues with NVM/NPM
- 🚀 Quick Start
- 📦 Installation
- 💻 Tech Stack
- 📖 API Documentation
- 🔧 Development
- 📝 License
- 🙋♀ Author
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that enables LLMs to perform Google searches via the Serper API, allowing models to retrieve current information from the web.Last updated -1315
- AsecurityFlicenseAqualityA Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.Last updated -241
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants to perform web searches using Google Search API, returning up to 20 search results in JSON format.Last updated -2Apache 2.0
- -securityAlicense-qualityA Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.Last updated -MIT License