harvestapi-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@harvestapi-mcp Find LinkedIn profiles of senior software engineers in Austin, TX."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
harvestapi-mcp
MCP server for HarvestAPI — LinkedIn profiles, companies, posts, jobs, leads, ads, groups, and platform account data over the Model Context Protocol (stdio).
All 25 tools are read-only. No message sending, no connection automation, no billing mutations.
Legal / Ethical Notice
This server is a thin wrapper over the HarvestAPI LinkedIn-data API. You are responsible for complying with LinkedIn's Terms of Service, HarvestAPI's Terms, and applicable data-protection laws (GDPR, etc.) when using LinkedIn-sourced data. Do not use harvested data to spam, harass, or violate privacy. The maintainers provide no warranty and accept no liability for how you use the tool.
HarvestAPI is a third-party scraping/enrichment service — it is not affiliated with LinkedIn.
Related MCP server: linkedin-mcp-pro
Prerequisites
Node.js 20+
A HarvestAPI key — get one at https://harvestapi.io/admin/api-keys
Install
git clone https://github.com/Hassan220022/harvestapi-mcp
cd harvestapi-mcp
npm ci
npm run buildOr run without cloning (after npm publish or via npx from the repo):
npx --yes github:Hassan220022/harvestapi-mcpEnvironment
Variable | Required | Default | Description |
| yes | — | Your HarvestAPI API key. Sent as |
| no |
| Override base URL (rarely needed). |
| no |
| Request timeout in ms. |
| no |
| Max retries for transient 5xx / 429 / timeout. Never retried for 401/403/422. |
Copy .env.example to .env for local dev — but do not commit .env.
cp .env.example .env
# edit .envConfigure
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"harvestapi": {
"command": "node",
"args": ["/absolute/path/to/harvestapi-mcp/dist/index.js"],
"env": {
"HARVESTAPI_KEY": "your_key_here"
}
}
}
}Generic MCP (any stdio client)
{
"command": "node",
"args": ["/path/to/harvestapi-mcp/dist/index.js"],
"env": { "HARVESTAPI_KEY": "your_key_here" }
}Using npx (no local build)
{
"mcpServers": {
"harvestapi": {
"command": "npx",
"args": ["-y", "github:Hassan220022/harvestapi-mcp"],
"env": { "HARVESTAPI_KEY": "your_key_here" }
}
}
}Tools
25 tools, all harvest_*. Every tool maps to a verified HarvestAPI endpoint — see docs/tool-mapping.md and docs/harvestapi-endpoint-inventory.json.
Tool | Description | Required params |
| Get LinkedIn profile | one of |
| Search LinkedIn profiles | — (all filters optional) |
| Get posts by a profile | one of |
| Get comments by a profile | one of |
| Get reactions by a profile | one of |
| Get LinkedIn company | one of |
| Search companies | — |
| Get posts by a company | one of |
| Get LinkedIn group | one of |
| Search groups | — |
| Resolve LinkedIn Geo ID by text |
|
| Get a LinkedIn post |
|
| Search LinkedIn posts | — |
| Get comments on a post |
|
| Get reactions on a post |
|
| Get reactions on a comment |
|
| Get replies to a comment |
|
| Get LinkedIn job | one of |
| Search LinkedIn jobs | — |
| Search leads (Sales Navigator) | — |
| Search LinkedIn services |
|
| Get LinkedIn ad | one of |
| Search LinkedIn ad library | — |
| Get your HarvestAPI user/account | — |
| Get your private LinkedIn account pools | — |
Intentionally excluded (5 endpoints): accept-connection, send-connection, send-message, received-connections, sent-connections — they automate LinkedIn user actions. See tool-mapping.
Examples
Profile lookup
{ "tool": "harvest_get_profile", "arguments": { "publicIdentifier": "williamhgates" } }Profile with enrichment flags
{ "tool": "harvest_get_profile", "arguments": { "url": "https://www.linkedin.com/in/williamhgates", "findEmail": "true", "skipSmtp": "true" } }Company
{ "tool": "harvest_get_company", "arguments": { "universalName": "google" } }Search profiles
{ "tool": "harvest_search_profiles", "arguments": { "search": "staff engineer", "currentCompany": "google", "page": "1" } }Post comments
{ "tool": "harvest_get_post_comments", "arguments": { "post": "https://www.linkedin.com/posts/.../..." } }Error & Rate-Limit Behavior
HTTP | Behavior |
401/403 |
|
404/422 |
|
429 |
|
5xx | Retried with exponential backoff (400 ms × 2^attempt, max 5 s) up to |
timeout |
|
HarvestAPI has no per-minute rate limit; concurrency limits are per plan (Free 1, Starter 5, Basic 10, Pro 20, Business 40) with queue size 10 — see https://docs.harvestapi.io/guides/concurrency.md. Exceeding queue returns an error; the client surfaces 429 with Retry-After when present.
Validation errors (missing required identifier, requireAtLeastOne) are local HarvestValidationError before any request.
Raw API payloads are preserved in responses. Email fields are only marked verified if the API says so.
Development
npm ci
npm run lint # eslint
npm run typecheck # tsc --noEmit
npm run build # tsc
npm test # vitest
npm run test:coverage
npm run check # lint + typecheck + build + testNeeds Node 20+.
Project Docs
Endpoint inventory (30 endpoints):
docs/harvestapi-endpoint-inventory.jsonResearch notes & source URLs:
docs/research-notes.mdTool mapping (Implemented / Intentionally Excluded):
docs/tool-mapping.mdRaw docs crawl:
docs/raw/*.md
Security
HARVESTAPI_KEYis only read from env (HARVESTAPI_KEY). Never logged, never included in error bodies beyond redacted hints.Never commit
.env..env.examplecontains placeholders only..gitignorecovers.env,node_modules,dist,coverage.Report security issues via GitHub Issues (do not post keys in issues).
Contributing
PRs welcome. Run npm run check before submitting. See docs/research-notes.md for how endpoints are sourced and validated.
License
MIT — see LICENSE.
Available Tools
25 toolsharvest_get_adA
Get LinkedIn Ad by ID — requires at least one of adId or url.
Inputs: url, adId.
harvest_get_comment_reactionsA
Get reactions of a LinkedIn post comment by comment URL.
Inputs: url (required), page.
harvest_get_comment_repliesA
Get replies of a LinkedIn post comment by comment URL.
Inputs: url (required), paginationToken.
harvest_get_companyA
Get LinkedIn company — requires at least one of url, universalName, search.
Inputs: url, search, universalName.
harvest_get_company_postsA
Get LinkedIn company posts — requires at least one of company, companyId, companyUniversalName.
Inputs: page, company, companyId, postedLimit, +3 more.
harvest_get_groupA
Get LinkedIn group — requires at least one of url or groupId.
Inputs: url, groupId.
harvest_get_jobA
Get LinkedIn job details — requires at least one of jobId or url.
Inputs: url, jobId.
harvest_get_my_api_userA
Get details about the API user associated with the provided API key.
Inputs: no named parameters.
harvest_get_my_private_account_poolsA
Get details about private account pools associated with the API user.
Inputs: no named parameters.
harvest_get_postA
Get LinkedIn post details by URL.
Inputs: url (required).
harvest_get_post_commentsB
Get comments of a LinkedIn post by post URL.
Inputs: post (required), page, sortBy, paginationToken.
harvest_get_post_reactionsA
Get reactions of a LinkedIn post by post URL.
Inputs: post (required), page.
harvest_get_profileA
Get LinkedIn profile — requires at least one of url, publicIdentifier, profileId. Flags: main, findEmail, skipSmtp, includeAboutProfile.
Inputs: url, main, skipSmtp, findEmail, +3 more.
harvest_get_profile_commentsB
Get comments of a LinkedIn profile — requires at least one of profile or profileId.
Inputs: page, profile, profileId, postedLimit, +1 more.
harvest_get_profile_postsB
Get LinkedIn profile posts — requires at least one of profile, profileId, profilePublicIdentifier.
Inputs: page, profile, profileId, postedLimit, +3 more.
harvest_get_profile_reactionsA
Get reactions of a LinkedIn profile — requires at least one of profile or profileId.
Inputs: page, profile, profileId, paginationToken.
harvest_search_adsB
Search LinkedIn Ad Library by keyword, advertiser, country, date range.
Inputs: enddate, keyword, countries, searchUrl, +4 more.
harvest_search_companiesA
Search LinkedIn companies by keywords, location, size, industry.
Inputs: page, geoId, search, location, +2 more.
harvest_search_geo_idA
Search LinkedIn Geo ID by location text — use to resolve geoId for other search endpoints.
Inputs: search (required).
harvest_search_groupsA
Search LinkedIn Groups by keywords.
Inputs: page, search.
harvest_search_jobsC
Search LinkedIn jobs by title, company, location, filters.
Inputs: page, geoId, salary, search, +11 more.
harvest_search_leadsB
Search LinkedIn leads (Sales Navigator) with advanced inclusion/exclusion filters. Supports 30+ filter params.
Inputs: page, geoIds, search, schools, +32 more.
harvest_search_postsB
Search LinkedIn posts by keywords, author, company, group, content type, date range.
Inputs: page, group, search, sortBy, +13 more.
harvest_search_profilesA
Search LinkedIn profiles by name, company, school, location, title, etc.
Inputs: page, geoId, title, school, +10 more.
harvest_search_servicesB
Search LinkedIn profile services by keywords and location.
Inputs: search (required), page, geoId, location.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Each tool targets a distinct LinkedIn resource-action pair, with clear separation between searching and getting entities. Within sub-resources, getters for posts, comments, reactions, and replies are unambiguous.
All tools follow the harvest_<verb>_<resource> pattern, using only 'get' and 'search' as verbs. Multi-word resources are hyphenated consistently, and there are no mixed naming conventions.
25 tools is on the higher end but appropriate for the broad scope of LinkedIn entities covered (ads, companies, groups, jobs, leads, posts, profiles, services, and account info). Each tool adds a distinct capability.
The read-only harvesting scope is well covered, with both search and get operations for most entities. Minor gaps include the absence of get_lead and get_service endpoints, but search results likely satisfy most needs.
Maintenance
Related MCP Connectors
Hosted LinkedIn MCP server on your own account: 35 tools for search, profiles, inbox, posts, pages.
Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.
A hosted LinkedIn MCP server for your own account. Paste one address into Claude, ChatGPT, Cursor or n8n to read your inbox, send messages and invitations, and search people. Free to start. Not made by LinkedIn.
LinkedIn API as MCP tools to retrieve profile data and publish content. Powered by HAPI MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceFully featured MCP server that provides automation tools for LinkedIn, supporting browser-based scraping and API-based operations for content management, media uploads, and reactions.64MIT
- AlicenseAqualityCmaintenanceSelf-hosted, ban-safe MCP server for LinkedIn that provides 22 tools for profiles, search, jobs, posts, connections, and messages. Integrates with any MCP-compatible client like Claude Desktop.581MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for LinkedIn API integration. Enables authentication, profile access, connections, search, messaging, and feed management via OAuth2.MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for AI-native LinkedIn prospecting. It enables lead research, audience building, conversation management, and controlled outreach actions such as messaging and publishing through an OAuth-protected remote endpoint.2MIT