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://smithery.ai/server/@chanmeng666/google-jobs-server)
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](https://serpapi.com/) 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](https://smithery.ai/server/@chanmeng666/google-jobs-server):
Manual Installation
<img src="https://cdn.simpleicons.org/npm/CB3837" height="14"/> <a href="https://www.npmjs.com/package/@chanmeng666/google-jobs-server">@chanmeng666/google-jobs-server</a>
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](./LICENSE).
Author
Created and maintained by [Chan Meng](https://chanmeng.live/).
[](https://github.com/ChanMeng666)
[](https://www.linkedin.com/in/chanmeng666/)