# LinkedIn MCP Server

An MCP (Model Context Protocol) server that provides access to LinkedIn data through the [HarvestAPI](https://harvest-api.com) service.

## Features

This MCP server provides comprehensive access to LinkedIn data including:

### Profile Operations
- **get_profile** - Get LinkedIn profile by URL, public identifier, or profile ID
- **search_profiles** - Search profiles by name, company, location, and other criteria
- **get_profile_posts** - Get posts from a LinkedIn profile
- **get_profile_comments** - Get comments made by a LinkedIn profile
- **get_profile_reactions** - Get reactions from a LinkedIn profile

### Company Operations
- **get_company** - Get company information by URL, universal name, or search
- **search_companies** - Search companies by keywords and filters
- **get_company_posts** - Get posts from a company page

### Job Operations
- **get_job** - Get job details by ID or URL
- **search_jobs** - Search jobs with various filters (location, salary, experience level, etc.)

### Post Operations
- **get_post** - Get post details by URL
- **search_posts** - Search posts by keywords and filters
- **get_post_comments** - Get comments on a post
- **get_post_reactions** - Get reactions on a post

### Group Operations
- **get_group** - Get group information by URL or ID
- **search_groups** - Search groups by keywords

### Utility Operations
- **search_geo_id** - Search LinkedIn Geo ID by location (useful for location-based filtering)

## Installation

```bash
npm install
npm run build
```

## Configuration

### Environment Variables

| Variable | Description |
|----------|-------------|
| `HARVESTAPI_API_KEY` or `LINKEDIN_API_KEY` | Your HarvestAPI API key (required) |
| `PROXY_URL` | HTTP/HTTPS proxy URL (optional) |

### Claude Desktop Configuration

Add to your Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/path/to/linkedin-mcp/build/index.js"],
      "env": {
        "HARVESTAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

## Usage Examples

### Get a LinkedIn Profile

```
Get the LinkedIn profile for https://www.linkedin.com/in/satyanadella/
```

### Search for Profiles

```
Search for software engineers at Google in San Francisco
```

### Search Jobs

```
Find remote software engineering jobs at Microsoft with salary 150k+
```

### Get Company Information

```
Get information about Apple's LinkedIn company page
```

### Search Posts

```
Search for posts about AI from the last 24 hours
```

## API Reference

### Profile Endpoints

#### get_profile
Get LinkedIn profile information.

Parameters:
- `url` (string, optional): LinkedIn profile URL
- `publicIdentifier` (string, optional): Public identifier from URL
- `profileId` (string, optional): LinkedIn profile ID
- `findEmail` (boolean, optional): Find email address
- `includeAboutProfile` (boolean, optional): Include detailed about section

#### search_profiles
Search LinkedIn profiles.

Parameters:
- `search` (string, required): Search query
- `currentCompany` (string, optional): Filter by current company
- `pastCompany` (string, optional): Filter by past company
- `school` (string, optional): Filter by school
- `firstName` (string, optional): Filter by first name
- `lastName` (string, optional): Filter by last name
- `title` (string, optional): Filter by job title
- `location` (string, optional): Filter by location
- `geoId` (string, optional): Filter by LinkedIn Geo ID
- `industryId` (string, optional): Filter by industry
- `page` (integer, optional): Page number

### Company Endpoints

#### get_company
Get LinkedIn company information.

Parameters:
- `url` (string, optional): Company URL
- `universalName` (string, optional): Company universal name
- `search` (string, optional): Company name to search

#### search_companies
Search LinkedIn companies.

Parameters:
- `search` (string, required): Search keywords
- `location` (string, optional): Filter by location
- `geoId` (string, optional): Filter by Geo ID
- `companySize` (string, optional): Filter by size (1-10, 11-50, etc.)
- `page` (integer, optional): Page number

### Job Endpoints

#### get_job
Get job details.

Parameters:
- `jobId` (string, optional): Job ID
- `url` (string, optional): Job URL

#### search_jobs
Search jobs with filters.

Parameters:
- `search` (string, optional): Job title search
- `companyId` (string, optional): Filter by company
- `location` (string, optional): Filter by location
- `geoId` (string, optional): Filter by Geo ID
- `sortBy` (string, optional): Sort by 'relevance' or 'date'
- `workplaceType` (string, optional): 'office', 'hybrid', 'remote'
- `employmentType` (string, optional): 'full-time', 'part-time', etc.
- `salary` (string, optional): '40k+', '60k+', '80k+', etc.
- `postedLimit` (string, optional): '24h', 'week', 'month'
- `experienceLevel` (string, optional): 'internship', 'entry', 'mid-senior', etc.
- `easyApply` (boolean, optional): Filter Easy Apply jobs
- `page` (integer, optional): Page number

### Post Endpoints

#### get_post
Get post details by URL.

Parameters:
- `url` (string, required): LinkedIn post URL

#### search_posts
Search posts.

Parameters:
- `search` (string, optional): Keywords to search
- `profile` (string, optional): Filter by author profile URL
- `profileId` (string, optional): Filter by author profile ID
- `company` (string, optional): Filter by company
- `postedLimit` (string, optional): '24h', 'week', 'month'
- `sortBy` (string, optional): 'relevance' or 'date'
- `page` (integer, optional): Page number

### Group Endpoints

#### get_group
Get group information.

Parameters:
- `url` (string, optional): Group URL
- `groupId` (string, optional): Group ID

#### search_groups
Search groups.

Parameters:
- `search` (string, required): Keywords to search
- `page` (integer, optional): Page number

### Utility Endpoints

#### search_geo_id
Search for LinkedIn Geo ID by location name.

Parameters:
- `search` (string, required): Location text to search

## License

MIT

## Credits

- Uses [HarvestAPI](https://harvest-api.com) for LinkedIn data access
- Built with [Model Context Protocol SDK](https://github.com/anthropics/mcp)