linkedin-mcp-server

Jing-yilin/linkedin-mcp-server

3.2

If you are the rightful owner of linkedin-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

An MCP server providing access to LinkedIn data via HarvestAPI.

LinkedIn MCP Server

An MCP (Model Context Protocol) server that provides access to LinkedIn data through the HarvestAPI 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

npm install
npm run build

Configuration

Environment Variables

VariableDescription
HARVESTAPI_API_KEY or LINKEDIN_API_KEYYour HarvestAPI API key (required)
PROXY_URLHTTP/HTTPS proxy URL (optional)

Claude Desktop Configuration

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

{
  "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