About Linkedin MCP Search
Linkedin MCP Search is an MCP server published by saisudhir14 in the Social category: mCP for LinkedIn Job Search.
The repository has 7 stars and 1 forks, with the last commit 10 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/saisudhir14/linkedin-mcp-searchThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Linkedin MCP Search
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 17 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
README
LinkedIn Job Search MCP
A Model Context Protocol (MCP) server for LinkedIn jobs, companies, and posts. Search jobs with LinkedIn's filters, read full job descriptions, look up companies, and find hiring posts from recruiters and managers. Works with Claude Desktop, Cursor, and other MCP clients.
Quick Start
Using npx (Recommended)
Add to your MCP client config:
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):
{
"mcpServers": {
"linkedin": {
"command": "npx",
"args": ["-y", "linkedin-mcp-search"]
}
}
}
Cursor (.cursor/mcp.json):
{
"mcpServers": {
"linkedin": {
"command": "npx",
"args": ["-y", "linkedin-mcp-search"]
}
}
}
Then restart your client.
Global Installation
npm install -g linkedin-mcp-search
{
"mcpServers": {
"linkedin": {
"command": "linkedin-mcp"
}
}
}
Features
- Job search with LinkedIn's filters: keywords, location/geoId/radius, company, job type, experience level, workplace type, date posted (down to the past hour), industry, job function, minimum salary, Easy Apply, and fewer than 10 applicants
- Pagination up to 100 results per call, with
nextStartto continue - Job details including full description, seniority, employment type, and industries
- Company lookup by name or vanity ID, and a company's open jobs
- Post search for public LinkedIn posts (e.g. "we're hiring" announcements), plus full post text, publish date, and engagement
- No login required
Available Tools
| Tool | Description |
|---|---|
search_jobs |
Full job search with all filters |
search_remote_jobs |
Quick remote job search |
search_entry_level_jobs |
Entry-level & internship search |
get_job_details |
Full job description and criteria |
get_company |
Company profile |
search_companies |
Find companies and their LinkedIn IDs |
get_company_jobs |
Open jobs at a company (name, vanity ID, or numeric ID) |
search_posts |
Search public LinkedIn posts, e.g. hiring announcements |
get_post_details |
Full text, author, date, and engagement of a post |
build_post_search_url |
LinkedIn post search link for a signed-in browser |
get_popular_locations |
Locations with LinkedIn geo IDs |
get_industries |
Industry IDs for the industryIds filter |
get_job_functions |
Function codes for the jobFunctions filter |
build_job_search_url |
LinkedIn job search link with filters |
Example Prompts
"Search for remote Golang jobs posted in the past hour"
"Find Forward Deployed Engineer jobs at Kyndryl"
"Show mid-senior engineering jobs in Seattle paying $160k+ with fewer than 10 applicants"
"Get details for LinkedIn job 4328991043"
"Find LinkedIn posts from people hiring Forward Deployed Engineers this week"
"Read this LinkedIn post: https://www.linkedin.com/posts/..."
Search Parameters
| Parameter | Type | Description |
|---|---|---|
keywords |
string | Search terms |
location |
string | City, state, or country |
geoId |
string | LinkedIn geographic ID |
distance |
number | Radius in miles (5, 10, 25, 50, 100) |
company |
string | Company name; only matching companies are returned |
companyIds |
array | Numeric LinkedIn company IDs |
jobType |
array | full-time, part-time, contract, temporary, internship, volunteer |
experienceLevel |
array | internship, entry-level, associate, mid-senior, director, executive |
workplaceType |
array | remote, hybrid, on-site |
datePosted |
string | past-hour, past-24-hours, past-week, past-month, any-time |
industryIds |
array | Industry IDs from get_industries |
jobFunctions |
array | Function codes from get_job_functions (e.g. eng, it) |
minSalary |
string | 40k to 200k in 20k steps (US jobs) |
easyApply |
boolean | Only Easy Apply jobs |
fewApplicants |
boolean | Only jobs with fewer than 10 applicants |
sortBy |
string | most-relevant, most-recent |
start |
number | Offset; pass nextStart from the previous result |
limit |
number | Max results (default: 25, max: 100) |
How post search works
LinkedIn only allows post search when signed in, so search_posts finds public posts with a web search for site:linkedin.com/posts. Results depend on what the search engine has indexed, so very recent posts may be missing. Each result includes linkedInSearchUrl, which opens LinkedIn's own post search in a browser where you're signed in, and source, which shows the provider used.
Recommended: add a Brave Search API key. Without a key, post search uses DuckDuckGo, which often blocks automated requests. Get a key at brave.com/search/api (a free plan is available) and add it to your MCP config:
{
"mcpServers": {
"linkedin": {
"command": "npx",
"args": ["-y", "linkedin-mcp-search"],
"env": { "BRAVE_SEARCH_API_KEY": "your-key-here" }
}
}
}
If Brave fails (for example, the monthly quota runs out), the server falls back to DuckDuckGo automatically.
| Environment variable | Required | Description |
|---|---|---|
BRAVE_SEARCH_API_KEY |
No | Brave Search API key for reliable post search |
Config File Locations
| Platform | Location |
|---|---|
| Claude Desktop (Mac) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor | .cursor/mcp.json |
Troubleshooting
"MCP server not found"
- Ensure Node.js 18+ is installed
- Restart client after config changes
"No jobs found"
- Try broader search terms
- Remove some filters
"Rate limited"
- Wait a few minutes between searches
License
MIT
Disclaimer
Not affiliated with LinkedIn. Uses LinkedIn's public (logged-out) pages and DuckDuckGo search. Use responsibly.
README fetched from the repository 17 hours ago. The original is authoritative.