Linkedin Jobs

A Model Context Protocol (MCP) server for searching and retrieving LinkedIn job postings via the RapidAPI LinkedIn Data API.

What is MCP?

Model Context Protocol (MCP) is a framework developed by Anthropic that allows AI models like Claude to interact with external tools and APIs. MCP enables Claude to execute code, access databases, retrieve information from the web, and more, significantly extending its capabilities beyond its training data.

MCP works by defining a set of tools that Claude can invoke through a standardized protocol. When Claude needs information that requires external access, it can call these tools, which execute the necessary operations and return results back to Claude. This allows Claude to provide more accurate, up-to-date, and contextually relevant responses.

Learn more about MCP from Anthropic's announcement.

Features

• Search for LinkedIn job postings using keywords
• Filter jobs by location
• Get detailed information about specific job postings
• Location search functionality for finding LinkedIn location IDs

Requirements

• Python 3.8+
• RapidAPI key with access to the LinkedIn Data API
• Required Python packages (see requirements.txt)

Installation

1. Clone this repository:

git clone https://github.com/rom7699/linkedin-jobs-mcp.git
cd linkedin-jobs-mcp

2. Install the required packages:

pip install -r requirements.txt

3. Create a .env file in the project root and add your RapidAPI key:

RAPIDAPI_KEY=your_rapidapi_key_here

Usage

Running the MCP Server

python main.py

This will start the MCP server using stdio transport, which is suitable for integrating with Claude via the Claude Desktop application.

Configuring Claude Desktop

To use this MCP server with Claude Desktop, add the following configuration to your claude_desktop_config.json:

{
    "mcpServers": {
        "mcp-linkedin": {
            "command": "/path/to/python",
            "args": [
                "--directory",
                "/path/to/linkedin-jobs-mcp",
                "run",
                "main.py"
            ]
        }
    }
}

Example configuration:

{
    "mcpServers": {
        "documentation": {
            "command": "/Users/Rom/.local/bin/uv",
            "args": [
            "--directory",
            "/Users/Rom/Documents/personal_projects/documentation",
            "run",
            "main.py"
            ]
        }
    }
}

Available Tools

The MCP server provides the following tools:

1. search_jobs(keywords, limit=10, location='Israel', format_output=True) - Search for jobs matching keywords in the specified location
2. get_job_details(job_id) - Get detailed information about a specific job posting
3. search_locations(keyword) - Search for LinkedIn location IDs by keyword

Example Interactions with Claude

Once your MCP server is configured with Claude Desktop, you can interact with it as follows:

Human: Find me software engineering jobs in Berlin.

Claude: I'll search for software engineering jobs in Berlin for you using the LinkedIn API.

[Claude uses the MCP server to fetch results]

Here are the top software engineering jobs in Berlin:

## Senior Software Engineer
- **Company**: Company XYZ
- **Location**: Berlin, Germany
- **Posted**: 2023-04-10
- **URL**: https://linkedin.com/jobs/view/12345

## Frontend Developer
- **Company**: Tech Startup Inc.
- **Location**: Berlin, Germany
- **Posted**: 2023-04-08
- **URL**: https://linkedin.com/jobs/view/67890

...

Credits

This project uses the LinkedIn Data API available through RapidAPI.

The MCP integration is built using Anthropic's Model Context Protocol.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.