Google Jobs MCP Server

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

屏幕截图 2024-12-31 183813

屏幕截图 2024-12-31 183754

屏幕截图 2024-12-31 180734

屏幕截图 2024-12-31 182106

✨ 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:

npm install

Configure environment: Modify your claude_desktop_config.json with the following content (adjust paths according to your system):

{
  "google-jobs": {
    "command": "D:\\Program\\nvm\\node.exe",
    "args": ["D:\\github_repository\\path_to\\dist\\index.js"],
    "env": {
      "SERP_API_KEY": "your-api-key"
    }
  }
}

Build the server:

npm run build

Start the server:

npm start

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:

npx -y @smithery/cli install @chanmeng666/google-jobs-server --client claude

Manual Installation

@chanmeng666/google-jobs-server

# 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

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.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

💻 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

# 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.

🙋‍♀ Author

Created and maintained by Chan Meng.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

search_jobs

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Google Custom Search Server
limklister
A
security
A
license
A
quality
A Model Context Protocol server that enables LLMs to perform web searches using Google's Custom Search API through a standardized interface.
Last updated -
1
23
TypeScript
MIT License
Google Cloud MCP Server
krzko
-
security
F
license
-
quality
A Model Context Protocol server that connects to Google Cloud services, allowing users to query logs, interact with Spanner databases, and analyze Cloud Monitoring metrics through natural language interaction.
Last updated -
16
2
TypeScript
Serper MCP Server
garylab
-
security
F
license
-
quality
A 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 -
2
Python
searchAPI-mcp
RmMargt
-
security
A
license
-
quality
A Model Context Protocol (MCP) based search API server that provides standardized access to Google Maps, Google Flights, Google Hotels and other services. This server enables AI assistants to access various search services through a unified interface.
Last updated -
48
Python
MIT License

View all related MCP servers