What is Linkedin Jobs Mcp Server

The linkedin-jobs-mcp-server is a Model Context Protocol (MCP) server designed for searching and retrieving LinkedIn job postings through the RapidAPI LinkedIn Data API.

Use cases

Use cases include integrating job search capabilities into applications, providing job recommendations based on user preferences, and enhancing recruitment tools with real-time job data from LinkedIn.

How to use

To use the linkedin-jobs-mcp-server, clone the repository, install the required Python packages, set up your RapidAPI key in a .env file, and run the server using the command ‘python main.py’.

Key features

Key features include searching for LinkedIn job postings using keywords, filtering jobs by location, retrieving detailed information about specific job postings, and location search functionality for finding LinkedIn location IDs.

Where to use

The linkedin-jobs-mcp-server can be used in job search applications, recruitment platforms, and any service that requires access to LinkedIn job postings.

LinkedIn Jobs MCP Server

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.