Google Jobs MCP Server

by ChanMeng666

Integrations

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

  1. Visit SERP API website 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:
npm install
  1. 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" } } }
  1. Build the server:
npm run build
  1. Start the server:
npm start

Troubleshooting

  1. API Key Issues:
  • Verify key in configuration
  • Check key status in SERP API dashboard
  • Confirm key has remaining quota
  1. 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.

A
security – no known vulnerabilities
A
license - permissive license
A
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.

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.

  1. 🌍 Multi-Language Support
    1. 🔍 Flexible Search Options
      1. 💡 Smart Error Handling
        1. 📊 Rich Job Details
          1. 🔄 Advanced Features
            1. 🔑 SERP API Setup Guide
              1. 👩‍🔧 Solution for MCP Servers Connection Issues with NVM/NPM
                1. 🚀 Quick Start
                  1. Troubleshooting
                2. 📦 Installation
                  1. Installing via Smithery
                  2. Manual Installation
                  3. Running evals
                3. 💻 Tech Stack
                  1. 📖 API Documentation
                    1. 🔧 Development
                      1. 📝 License
                        1. 🙋‍♀ Author

                          Related MCP Servers

                          • 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
                            7
                            TypeScript
                            MIT License
                          • -
                            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
                          • -
                            security
                            F
                            license
                            -
                            quality
                            A Model Context Protocol server that enables Claude to perform Google Custom Search operations by connecting to Google's search API.
                            Last updated -
                            Python
                            • Linux
                          • -
                            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 -
                            1
                            Python

                          View all related MCP servers

                          ID: bijbpfhrbx