Google Jobs MCP Server
by ChanMeng666
<div align="center">
<h1><img src="public/server-google-jobs.svg" width="80px"><br/>Google Jobs MCP Server</h1>
<img src="https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white"/>
<img src="https://img.shields.io/badge/Node.js-43853D?style=flat&logo=node.js&logoColor=white"/>
<img src="https://img.shields.io/badge/MCP-Server-blue?style=flat"/>
<img src="https://img.shields.io/badge/License-MIT-brightgreen?style=flat"/>
<a href="https://smithery.ai/server/@chanmeng666/google-jobs-server"><img alt="Smithery Badge" src="https://smithery.ai/badge/@chanmeng666/google-jobs-server"></a>
</div>
<br/>
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.
<a href="https://glama.ai/mcp/servers/bijbpfhrbx">
<img width="380" height="200" src="https://glama.ai/mcp/servers/bijbpfhrbx/badge" alt="Google Jobs Server MCP server" />
</a>
<br/>
[](https://smithery.ai/server/@chanmeng666/google-jobs-server)
<br/>
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:
1. Visit [SERP API website](https://serpapi.com/) and create an account
2. After registration, go to your Dashboard:
- Locate the "API Key" section
- Copy your API key
- New users get 100 free API calls
3. 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.
4. 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
1. Install dependencies:
```bash
npm install
```
2. Configure environment:
Modify your `claude_desktop_config.json` with the following content (adjust paths according to your system):
```json
{
"google-jobs": {
"command": "D:\\Program\\nvm\\node.exe",
"args": ["D:\\github_repository\\path_to\\dist\\index.js"],
"env": {
"SERP_API_KEY": "your-api-key"
}
}
}
```
3. Build the server:
```bash
npm run build
```
4. Start the server:
```bash
npm start
```
## Troubleshooting
1. API Key Issues:
- Verify key in configuration
- Check key status in SERP API dashboard
- Confirm key has remaining quota
2. 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):
```bash
npx -y @smithery/cli install @chanmeng666/google-jobs-server --client claude
```
## 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>
```bash
# Using npm
npm i @chanmeng666/google-jobs-server
# or
npm install @chanmeng666/google-jobs-server
# Using yarn
yarn add @chanmeng666/google-jobs-server
# Using pnpm
pnpm add @chanmeng666/google-jobs-server
```
# 💻 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
```bash
# Run in development mode
npm run dev
# Run type checking
npm run typecheck
# Build for production
npm run build
```
# 📝 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/)