Content
# LinkedIn MCP Server
A Model Context Protocol (MCP) server that enables interaction with LinkedIn through Claude and other AI assistants. This server allows you to scrape LinkedIn profiles, companies, jobs, and perform job searches.
## 📋 Features
- **Profile Scraping**: Get detailed information from LinkedIn profiles
- **Company Analysis**: Extract company information, including employees if desired
- **Job Search**: Search for jobs and get recommended positions
## 🔧 Installation
### Prerequisites
- Python 3.8 or higher
- Chrome browser installed
- ChromeDriver matching your Chrome version
- A LinkedIn account
### Step 1: Clone or Download the Repository
```bash
git clone https://github.com/stickerdaniel/linkedin-mcp-server
cd linkedin-mcp-server
```
Or download and extract the zip file.
### Step 2: Set Up a Virtual Environment
Using `uv` (recommended):
```bash
# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create and activate virtual environment
uv venv
source .venv/bin/activate # On macOS/Linux
# OR
.venv\Scripts\activate # On Windows
```
### Step 3: Install Dependencies
Using `uv`:
```bash
uv add "mcp[cli]" selenium httpx inquirer pyperclip
uv add "git+https://github.com/stickerdaniel/linkedin_scraper.git"
```
### Step 4: Install ChromeDriver
ChromeDriver is required for Selenium to interact with Chrome. You need to install the version that matches your Chrome browser.
1. **Check your Chrome version**:
- Open Chrome and go to the menu (three dots) > Help > About Google Chrome
- Note the version number (e.g., 123.0.6312.87)
2. **Download matching ChromeDriver**:
- Go to [ChromeDriver Downloads](https://chromedriver.chromium.org/downloads) / [Chrome for Testing](https://googlechromelabs.github.io/chrome-for-testing/) (Chrome-Version 115+)
- Download the version that matches your Chrome version
- Extract the downloaded file
3. **Make ChromeDriver accessible**:
- **Option 1**: Place it in a directory that's in your PATH (e.g., `/usr/local/bin` on macOS/Linux)
- **Option 2**: Set the CHROMEDRIVER environment variable to the path where you placed it:
```bash
export CHROMEDRIVER=/path/to/chromedriver # macOS/Linux
# OR
set CHROMEDRIVER=C:\path\to\chromedriver.exe # Windows
```
- **Option 3**: The server will attempt to auto-detect or prompt you for the path when run
## 🚀 Running the Server
1. **Start the server**:
```bash
# Using uv (recommended)
uv run main.py
```
2. **First-run setup**:
- You'll be prompted for your LinkedIn credentials on first run
- Credentials are stored on your local machine with user-only permissions
- ChromeDriver will be detected or you'll be prompted to specify its location
3. **Configure Claude Desktop**:
- The server will display and copy to your clipboard the configuration needed for Claude Desktop
- Open Claude Desktop and go to Settings > Developer > Edit Config
- Paste the configuration provided by the server
## 🔄 Using with Claude Desktop
1. **After adding the configuration** to Claude Desktop, restart the application
2. **Start a conversation** with Claude
3. **You'll see tools available** in the tools menu (hammer icon) after a few seconds (server checks chromedriver
4. **You can now ask Claude** to retrieve LinkedIn profiles, search for jobs, etc.
Examples of what you can ask Claude:
- "Can you tell me about Daniels work experience? His LinkedIn profile is https://www.linkedin.com/in/stickerdaniel/
- "Search for machine learning engineer jobs on LinkedIn"
- "Tell me about Google as a company based on their LinkedIn page"
## 🔐 Security and Privacy
- Your LinkedIn credentials are stored locally at `~/.linkedin_mcp_credentials.json` with user-only permissions
- Credentials are never exposed to Claude or any other AI and are only used for the LinkedIn login to scrape data
- The server runs on your local machine, not in the cloud
- All LinkedIn scraping happens through your account - be aware that profile visits are visible to other users
## ⚠️ Troubleshooting
### ChromeDriver Issues
If you encounter ChromeDriver errors:
1. Ensure your Chrome browser is updated
2. Download the matching ChromeDriver version
3. Set the CHROMEDRIVER path correctly
4. Try running with administrator/sudo privileges if permission issues occur
### Authentication Issues
If login fails:
1. Verify your LinkedIn credentials
2. Check if your account has two-factor authentication enabled
3. Try logging in manually to LinkedIn first, then run the server
4. Check your LinkedIn mobile app for a login request after running the server
5. Try to run the server with `--no-headless` to see where the login fails
6. Try to run the server with `--debug` to see more detailed logs
### Connection Issues
If Claude cannot connect to the server:
1. Ensure the server is running when you start it manually
2. Verify the configuration in Claude Desktop is correct
3. Restart Claude Desktop
## 📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
## 🙏 Acknowledgements
- Based on the [LinkedIn Scraper](https://github.com/joeyism/linkedin_scraper) by joeyism
- Uses the Model Context Protocol (MCP) for integration with AI assistants
---
**Note**: This tool is for personal use only. Use responsibly and in accordance with LinkedIn's terms of service. Web scraping may violate LinkedIn's terms of service in some cases.
