# 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._