LinkedIn

LinkedIn Model Context Protocol (MCP) Server

A powerful Model Context Protocol server for LinkedIn interactions that enables AI assistants to search for jobs, generate resumes and cover letters, and manage job applications programmatically.

Features

Authentication: Secure LinkedIn authentication with session management
Profile Management: Access and update LinkedIn profile information
Job Search: Search for jobs with flexible filtering options
Resume Generation: Create customized resumes from LinkedIn profiles
Cover Letter Generation: Generate tailored cover letters for specific job applications
Job Applications: Submit and track job applications

Architecture

This project implements the Model Context Protocol (MCP) specification, allowing AI assistants to interact with LinkedIn through standardized JSON-RPC style requests and responses.

Components:

MCP Handler: Routes requests to appropriate service handlers
API Modules: Specialized modules for LinkedIn interactions (auth, job search, profile, etc.)
Core Protocol: Defines request/response structures and data models
Utilities: Configuration management and helper functions

Installation

# Clone the repository
git clone https://github.com/yourusername/linkedin-mcp.git
cd linkedin-mcp

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Configuration

Create a .env file in the project root with the following variables:

# LinkedIn Credentials
LINKEDIN_USERNAME=your_email@example.com
LINKEDIN_PASSWORD=your_password

# API Settings
OPENAI_API_KEY=your_openai_api_key
SESSION_DIR=sessions
DATA_DIR=data

Usage

Starting the Server

python server.py

Example MCP Requests

Authentication

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "linkedin.login",
  "params": {
    "username": "user@example.com",
    "password": "password123"
  }
}

Searching for Jobs

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "linkedin.searchJobs",
  "params": {
    "filter": {
      "keywords": "software engineer",
      "location": "New York, NY",
      "distance": 25
    },
    "page": 1,
    "count": 20
  }
}

Generating a Resume

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "linkedin.generateResume",
  "params": {
    "profileId": "user123",
    "template": "standard",
    "format": "pdf"
  }
}

Available Methods

Method	Description
`linkedin.login`	Authenticate with LinkedIn
`linkedin.logout`	End the current session
`linkedin.checkSession`	Check if the current session is valid
`linkedin.getFeed`	Get LinkedIn feed posts
`linkedin.getProfile`	Get LinkedIn profile information
`linkedin.getCompany`	Get company profile information
`linkedin.searchJobs`	Search for jobs with filters
`linkedin.getJobDetails`	Get detailed information about a job
`linkedin.getRecommendedJobs`	Get job recommendations
`linkedin.generateResume`	Generate a resume from a LinkedIn profile
`linkedin.generateCoverLetter`	Generate a cover letter for a job application
`linkedin.tailorResume`	Customize a resume for a specific job
`linkedin.applyToJob`	Apply to a job
`linkedin.getApplicationStatus`	Check application status
`linkedin.getSavedJobs`	Get saved jobs
`linkedin.saveJob`	Save a job for later

Development

Project Structure

linkedin-mcp/
├── README.md
├── requirements.txt
├── server.py
├── data/
│   ├── applications/
│   ├── companies/
│   ├── cover_letters/
│   ├── jobs/
│   ├── profiles/
│   └── resumes/
├── linkedin_mcp/
│   ├── api/
│   │   ├── auth.py
│   │   ├── cover_letter_generator.py
│   │   ├── job_application.py
│   │   ├── job_search.py
│   │   ├── profile.py
│   │   └── resume_generator.py
│   ├── core/
│   │   ├── mcp_handler.py
│   │   └── protocol.py
│   └── utils/
│       └── config.py
├── sessions/
└── templates/
    ├── cover_letter/
    │   └── standard.html
    └── resume/
        └── standard.html

Running Tests

pytest

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

LinkedIn API documentation
Model Context Protocol specification