# LinkedIn MCP Server
Access LinkedIn directly from your AI assistant. Search for people, jobs, companies, and groups — all through natural conversation.
## What You Can Do
| Feature | Description |
| ------------------------ | ---------------------------------------------------------------------- |
| 🔍 **Search People** | Find professionals by name, company, location, or industry |
| 💼 **Search Jobs** | Discover job opportunities with filters for remote, salary, experience |
| 🏢 **Search Companies** | Research companies by size, industry, or headquarters |
| 👥 **Search Groups** | Find professional communities and networking groups |
| 👤 **View Profiles** | Get detailed information about any LinkedIn member |
| 📋 **View Your Profile** | See your own profile as others see it |
---
## Installation
```bash
git clone https://github.com/damionrashford/LINKEDIN-MCP.git
cd LINKEDIN-MCP
npm install
npm run build
npm link
```
### For Cursor IDE
Add this to your `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"linkedin": {
"command": "npx",
"args": ["linkedin-mcp"]
}
}
}
```
That's it! No args needed — just the command name.
### Run Manually (for testing)
```bash
linkedin-mcp
```
---
## Getting Started
### Step 1: Log into LinkedIn
Make sure you're logged into LinkedIn in your **Chrome browser**. That's it — no API keys, no passwords to configure.
### Step 2: Authenticate
Ask your AI assistant:
> "Authenticate with LinkedIn"
You'll receive a **session ID** that's valid for 1 hour. Your assistant will automatically use this for all LinkedIn requests.
### Step 3: Start Searching
Now you can ask things like:
> "Search for software engineers in San Francisco"
> "Find remote AI jobs posted this week"
> "Show me information about Microsoft"
> "What groups exist for Python developers?"
---
## Example Conversations
### Finding People
> **You:** Find product managers at Google
> **Assistant:** _Returns list of product managers currently at Google_
> **You:** Search for UX designers in my network
> **Assistant:** _Shows 1st and 2nd degree connections who are UX designers_
### Job Hunting
> **You:** Find remote software engineering jobs paying over $120k
> **Assistant:** _Returns matching job listings with company, location, and apply links_
> **You:** Show me jobs at Shopify posted in the last 24 hours
> **Assistant:** _Lists recent Shopify job openings_
### Researching Companies
> **You:** Tell me about Stripe
> **Assistant:** _Returns company details: industry, size, headquarters, description_
> **You:** Find tech startups with 50-200 employees
> **Assistant:** _Shows companies matching that size range_
### Viewing Profiles
> **You:** Show me Satya Nadella's profile
> **Assistant:** _Returns full profile with experience, education, skills_
> **You:** What does my LinkedIn profile look like?
> **Assistant:** _Shows your complete profile information_
---
## Search Filters
### People Search
- **Location** — Search by country, city, or region
- **Company** — Current employer
- **Industry** — Technology, Finance, Healthcare, etc.
- **School** — Alumni from specific universities
- **Network** — 1st, 2nd, or 3rd+ connections
### Job Search
- **Workplace** — On-site, Remote, or Hybrid
- **Experience Level** — Intern through Executive
- **Job Type** — Full-time, Part-time, Contract
- **Posted** — Last 24 hours, week, or month
- **Salary** — $40k+ through $120k+
- **Easy Apply** — LinkedIn quick apply only
### Company Search
- **Size** — From 1-10 employees to 10,000+
- **Headquarters** — Filter by location
### Group Search
- **Member Count** — Find active groups with 10,000+ members
---
## Tips for Best Results
1. **Be specific** — "Python developers in Toronto" works better than just "developers"
2. **Use filters** — Ask for "remote jobs" or "large companies" to narrow results
3. **Check your session** — If you get authentication errors, just ask to authenticate again
4. **Rate limits** — LinkedIn may limit requests if you search too frequently. Wait a few minutes if this happens.
---
## Privacy & Security
- **No passwords stored** — Authentication uses your existing Chrome login
- **Session-based** — Each session expires after 1 hour
- **Read-only** — This server only reads LinkedIn data, it cannot modify your profile or send messages
---
## Troubleshooting
| Issue | Solution |
| --------------------------- | ----------------------------------------------- |
| "No LinkedIn cookies found" | Make sure you're logged into LinkedIn in Chrome |
| "Session expired" | Ask to authenticate again |
| "API error: 429" | Too many requests — wait a few minutes |
| "Profile not found" | Check the username spelling |
---
## Requirements
- **Node.js 18+**
- **Chrome browser** with an active LinkedIn login
- **macOS** may prompt for Keychain access (click Allow)
---
## Need Help?
If you encounter issues:
1. Make sure you're logged into LinkedIn in Chrome
2. Try authenticating again
3. Wait a few minutes if you're getting rate limited
---
_This MCP server uses LinkedIn's internal API to provide search and profile viewing capabilities. It requires an active LinkedIn account and Chrome browser._
