How to integrate HarvestAPI MCP with Hermes

Connect Hermes to HarvestAPI MCP. Search linkedin for senior engineers in austin, enrich a linkedin profile with company data, and more using natural language, with authentication handled for you.

HarvestAPI logoHarvestAPI
Api Key

HarvestAPI is a recruiting and lead intelligence service for LinkedIn people and company data. It helps teams find prospects and enrich profiles with useful company insights.

32 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your HarvestAPI account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate HarvestAPI with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating HarvestAPI with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to HarvestAPI

Ask your agent to connect to HarvestAPI, or simply request any HarvestAPI-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new HarvestAPI connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to HarvestAPI or request any HarvestAPI-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the HarvestAPI MCP server, and what's possible with it?

The HarvestAPI MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your HarvestAPI account. It provides structured and secure access to LinkedIn people, company, job, post, event, group, ad, and service search and enrichment tools, so your agent can find prospects and candidates, enrich professional and company profiles, research market activity, and gather recruiting and sales intelligence on your behalf.

  • People and lead discovery: Have your agent search LinkedIn profiles and leads by person, employer, title, location, industry, school, recruiting criteria, or sales filters.
  • Company research and enrichment: Let the agent find companies, enrich company profiles, review hiring and headcount trends, and gather revenue, competitor, news, and key-person insights.
  • Professional profile intelligence: Direct your agent to enrich a LinkedIn profile from a profile link, public identifier, or work email, then retrieve its posts, comments, and reactions.
  • LinkedIn content research: Instruct your agent to search and retrieve posts, comments, reactions, ads, events, groups, and service-provider profiles using relevant keywords and filters.
  • Recruiting and hiring research: Have your agent search LinkedIn jobs by title, company, location, work arrangement, employment type, salary, seniority, industry, or recency, then retrieve details for specific roles.

Way Forward

With HarvestAPI connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every HarvestAPI action and event your agent gets out of the box.

Get LinkedIn Account Insights

Get broad LinkedIn company intelligence including company and revenue data, AI-generated sourced summaries, competitors, key people, headcount, hiring, news, suggested contacts, and alerts.

Get LinkedIn Ad

Get detailed creative, advertiser, impression, and targeting data for one LinkedIn ad.

Get LinkedIn Comment Reactions

Get one page of reactions to a LinkedIn comment.

Get LinkedIn Company

Enrich one LinkedIn company by company URL, universal name, or company ID.

Get LinkedIn Company People Stats

Return aggregate LinkedIn employee distributions for a company across location, school, function, skills, services, and fields of study.

Get LinkedIn Company Posts

Get one page of posts from a LinkedIn company.

Get LinkedIn Event

Get one LinkedIn event by URL or ID, including timing, venue, organizer, speakers, and announcement post.

Get LinkedIn Group

Get complete details for one LinkedIn group.

Get LinkedIn Job

Get complete details for one LinkedIn job.

Get My API User

Return details for the HarvestAPI user associated with the connected API key.

Get My Private Account Pools

Return private LinkedIn account-pool details associated with the connected HarvestAPI API user.

Get LinkedIn Post

Get one LinkedIn post by URL.

Get LinkedIn Post Comment Replies

Get one page of replies to a LinkedIn comment.

Get LinkedIn Post Comments

Get one page of comments for a LinkedIn post.

Get LinkedIn Post Reactions

Get one page of reactions to a LinkedIn post.

Get LinkedIn Profile

Enrich one LinkedIn profile by URL, public identifier, or profile ID.

Get LinkedIn Profile by Email

Reverse lookup a LinkedIn profile from a work email address.

Get LinkedIn Profile Comments

Get one page of comments authored by a LinkedIn profile, optionally limited by age.

Get LinkedIn Profile Posts

Use this dedicated profile feed to retrieve a profile's complete authored-post history one page at a time; unlike SEARCH_POSTS, it is intended for complete profile post retrieval.

Get LinkedIn Profile Reactions

Get one page of reactions made by a LinkedIn profile.

Search LinkedIn Accounts

Find LinkedIn companies with advanced recruiting and sales filters such as growth, hiring, department headcount, activity, and exclusions, returning one 25-result page.

Search LinkedIn Ads

Search the LinkedIn Ad Library by a complete search URL or structured keyword, advertiser, country, and date filters, returning one page.

Search LinkedIn Companies

Find LinkedIn companies by name keywords, location, size, or industry and return one controllable result page.

Search LinkedIn Events

Search LinkedIn events by keywords and return one controllable page.

Search LinkedIn Geo IDs

Resolve location text to LinkedIn Geo IDs for precise people and company search filters.

Search LinkedIn Groups

Search LinkedIn groups by keyword and return one controllable result page.

Search LinkedIn Jobs

Search LinkedIn jobs by title, company, location, work arrangement, employment type, salary, recency, seniority, industry, or function and return one controllable page.

Search LinkedIn Leads

Search LinkedIn people for recruiting candidates or sales prospects with advanced inclusion and exclusion filters, including a Sales Navigator search URL, and return one controllable result page.

Search LinkedIn Posts

Search LinkedIn posts by keywords, authors, companies, mentions, content type, group, and date controls, returning one page only.

Search LinkedIn Profiles

Search public LinkedIn profiles by person, employer, school, title, location, industry, or follower relationship and return one result page.

Search LinkedIn Services

Search LinkedIn service-provider profiles by service or name keywords and location.

Search LinkedIn Typeahead

Return LinkedIn search-bar suggestions or one page of company, school, or profile suggestions.

FAQ

Frequently asked questions

Start with HarvestAPI.It takes 30 seconds.

Managed auth, hosted MCP servers, and every HarvestAPI tool your agent needs.Free to start.

Start building