Skip to main content
Glama
deenesjakoruzh
FuriousApe

LinkedIn Jobs MCP Server

by FuriousApe
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

LinkedIn Jobs MCP Server

Self-hosted MCP server that scrapes LinkedIn jobs via the linkedin-api Voyager wrapper. Runs in Docker. No Apify, no per-run costs.

Setup

1. Configure credentials

cp .env.example .env
# Edit .env and fill in your LinkedIn email and password

⚠️ Use a burner LinkedIn account — automated access violates LinkedIn's ToS and risks the account being restricted.

2. Build and test

# Build the Docker image
docker build -t linkedin-mcp .

# Quick smoke test — should print the MCP server startup log
docker run --rm --env-file .env linkedin-mcp
# Ctrl+C to stop

3. Wire into Claude Desktop

Edit your Claude Desktop config file:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "linkedin-jobs": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "--env-file", "/ABSOLUTE/PATH/TO/linkedin-mcp/.env",
        "linkedin-mcp"
      ]
    }
  }
}

⚠️ Use the absolute path to your .env file. ~/ does not expand here.

4. Restart Claude Desktop

After saving the config, fully quit and reopen Claude Desktop. You'll see a 🔧 tools icon in the chat bar — click it to confirm scrape_jobs, get_job_details, and check_auth are listed.

5. First conversation

You: Check if my LinkedIn session is authenticated
Claude: [calls check_auth] ✓ Authenticated as John Doe

You: Scrape 20 AI Engineer or ML Engineer jobs posted in the last 3 days in the US
Claude: [calls scrape_jobs] ...returns full job list with descriptions

Related MCP server: mcp-job-search

Development

# Run with live source reloading
docker compose up

# Inspect MCP tools without Claude Desktop
npx @modelcontextprotocol/inspector docker run --rm -i --env-file .env linkedin-mcp

Project structure

linkedin-mcp/
├── src/
│   ├── server.py        # MCP server — tool definitions and handlers
│   ├── scraper.py       # linkedin-api Voyager wrapper calls
│   ├── models.py        # Pydantic models for Job data
│   └── __init__.py
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
├── .env.example
└── .gitignore

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • linkedin-mcp-pro

    horizonbymuneeb
    A
    license
    A
    quality
    C
    maintenance
    Self-hosted, ban-safe MCP server for LinkedIn that provides 22 tools for profiles, search, jobs, posts, connections, and messages. Integrates with any MCP-compatible client like Claude Desktop.
    58
    1
    MIT

  • mcp-job-search

    rajivdatta
    A
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that finds recent job postings based on your LinkedIn profile, scores each against your resume, and logs the results — all without logging into or scraping LinkedIn.
    MIT

  • linkedin-ops

    yasir-ali9
    F
    license
    Not graded
    quality
    C
    maintenance
    MCP server that enables AI assistants to search LinkedIn for job posts, save them locally, and manage them via a React dashboard.
    -