Google Jobs

by chanmeng666

7 stars

527 downloads

Not rated

GitHub Website

About

Integrates with Google Jobs search via Serp API to enable efficient querying and retrieval of job listings for career guidance, labor market analysis, and automated job matching.

Details

Author: chanmeng666
Repository: ChanMeng666/server-google-jobs
GitHub stars: 7
Downloads: 527
License: MIT License
Categories: Productivity, Developer Tools, Design, AI, Search, Frontend, API, Infrastructure, Automation

- Multi-language support (English, Chinese, Japanese, Korean)
- Flexible search parameters (query, location, radius, employment type, salary, post date, sort)
- Smart error handling with search refinement suggestions
- Rich job details including benefits, salary, and application links
- Pagination support with 10 results per page
- Geographic radius search and employment type filtering

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Google Jobs

Command (node, npx, python, etc.) node
Arguments
- Argument 1 D:\github_repository\path_to\dist\index.js
Environment
- SERP_API_KEY your-api-key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Install via npm (npm i @chanmeng666/google-jobs-server) or via Smithery. Configure claude_desktop_config.json with the server command pointing to the built dist/index.js and set the SERP_API_KEY environment variable. Build the server with npm run build and start with npm start. AI assistants can then call the search_jobs tool with search parameters.

`search_jobs`

Search for jobs based on specific parameters including query (required), location (optional), posted_age (optional), employment_type (optional), salary (optional), radius (optional), hl (optional), page (optional), and sort_by (optional).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

<div align="center">
<h1><br/>Google Jobs MCP Server</h1>

<a href="https://smithery.ai/server/@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.