# How to integrate HarvestAPI MCP with Atomic Agent

```json
{
  "title": "How to integrate HarvestAPI MCP with Atomic Agent",
  "toolkit": "HarvestAPI",
  "toolkit_slug": "harvestapi",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/harvestapi/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/harvestapi/framework/atomic-agent.md",
  "updated_at": "2026-11-19T05:33:02.837Z"
}
```

## Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including HarvestAPI.
This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a HarvestAPI account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.
For exact tool slugs and parameter tables, see the [tool catalog in the Composio docs](https://docs.composio.dev/toolkits/harvestapi).

## Also integrate HarvestAPI with

- [ChatGPT](https://composio.dev/toolkits/harvestapi/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/harvestapi/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/harvestapi/framework/hermes-agent)

## TL;DR

### How Atomic Agent connects to HarvestAPI
Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.
Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

## Connect HarvestAPI to Atomic Agent

### Connect HarvestAPI to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
- Ask Atomic Agent to do something in HarvestAPI. It searches Composio for the right tool.
- On first use, open the sign-in link returned in the chat. Connect your HarvestAPI account, then return to Atomic Agent to continue.
### Headless setup
Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

```bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY
```

## 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.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `HARVESTAPI_GET_ACCOUNT_INSIGHTS` | 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. Generated summaries are not verified facts. This provider-scraping read can return identifiable executives, leads, posts, and relationship signals; billing, credit use, and account-tier behavior are unverified. |
| `HARVESTAPI_GET_AD` | Get LinkedIn Ad | Get detailed creative, advertiser, impression, and targeting data for one LinkedIn ad. Callers can provide an ID or URL. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_COMMENT_REACTIONS` | Get LinkedIn Comment Reactions | Get one page of reactions to a LinkedIn comment. This provider-scraping read returns reactors' profile identity and position; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_COMPANY` | Get LinkedIn Company | Enrich one LinkedIn company by company URL, universal name, or company ID. This is a provider-scraping read; billing and account-tier behavior are not verified. |
| `HARVESTAPI_GET_COMPANY_PEOPLE_STATS` | Get LinkedIn Company People Stats | Return aggregate LinkedIn employee distributions for a company across location, school, function, skills, services, and fields of study. This is a provider-scraping read; billing, credit use, and account-tier behavior are unverified. |
| `HARVESTAPI_GET_COMPANY_POSTS` | Get LinkedIn Company Posts | Get one page of posts from a LinkedIn company. Date post-filtering can make provider pagination metadata inaccurate. This provider-scraping read may consume credits; billing and account-tier behavior are not verified. |
| `HARVESTAPI_GET_EVENT` | Get LinkedIn Event | Get one LinkedIn event by URL or ID, including timing, venue, organizer, speakers, and announcement post. This provider-scraping read may expose personal names, profile URLs, photos, and headlines and may consume HarvestAPI credits; billing and account-tier behavior are unverified. |
| `HARVESTAPI_GET_GROUP` | Get LinkedIn Group | Get complete details for one LinkedIn group. Callers can provide a URL or group ID. Results may identify group administrators. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_JOB` | Get LinkedIn Job | Get complete details for one LinkedIn job. Callers can provide a job ID or URL. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_MY_API_USER` | Get My API User | Return details for the HarvestAPI user associated with the connected API key. Use this to identify the connected account without consuming scraping credits. The response may contain account-identifying information because the provider does not document its fields. |
| `HARVESTAPI_GET_MY_PRIVATE_ACCOUNT_POOLS` | Get My Private Account Pools | Return private LinkedIn account-pool details associated with the connected HarvestAPI API user. This platform account-metadata read does not invoke a LinkedIn scraping endpoint or consume scraping credits. The undocumented response may contain sensitive pool and backing-account identifiers. |
| `HARVESTAPI_GET_POST` | Get LinkedIn Post | Get one LinkedIn post by URL. This provider-scraping read may consume HarvestAPI credits and returns authored content and author identity; billing and account-tier behavior are not verified. |
| `HARVESTAPI_GET_POST_COMMENT_REPLIES` | Get LinkedIn Post Comment Replies | Get one page of replies to a LinkedIn comment. This provider-scraping read returns repliers' identities, profile details, and authored text. Billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_POST_COMMENTS` | Get LinkedIn Post Comments | Get one page of comments for a LinkedIn post. This provider-scraping read returns commenters' identities, profile details, and authored text. Billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_POST_REACTIONS` | Get LinkedIn Post Reactions | Get one page of reactions to a LinkedIn post. This provider-scraping read returns reactors' profile identity and position; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_PROFILE` | Get LinkedIn Profile | Enrich one LinkedIn profile by URL, public identifier, or profile ID. Profile enrichment consumes HarvestAPI credits; main=true uses fewer credits. find_email=true explicitly opts into separately billable email discovery and SMTP validation and may return professional or publicly disclosed personal email addresses, including risky catch-all results. |
| `HARVESTAPI_GET_PROFILE_BY_EMAIL` | Get LinkedIn Profile by Email | Reverse lookup a LinkedIn profile from a work email address. This provider-scraping read exposes personal identity, employment, profile, and supplied email data. It consumes HarvestAPI credits; exact billing and account-tier behavior are unverified. Personal email domains and role addresses may be rejected. |
| `HARVESTAPI_GET_PROFILE_COMMENTS` | Get LinkedIn Profile Comments | Get one page of comments authored by a LinkedIn profile, optionally limited by age. This provider-scraping read exposes a person's authored activity, identity, and profile details. Billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_PROFILE_POSTS` | 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. Date post-filtering can make provider pagination metadata inaccurate. This provider-scraping read may consume credits and returns a person's authored content and identity; billing and account-tier behavior are not verified. |
| `HARVESTAPI_GET_PROFILE_REACTIONS` | Get LinkedIn Profile Reactions | Get one page of reactions made by a LinkedIn profile. This provider-scraping read exposes a person's reaction activity and profile identity; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_ACCOUNTS` | 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. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_ADS` | Search LinkedIn Ads | Search the LinkedIn Ad Library by a complete search URL or structured keyword, advertiser, country, and date filters, returning one page. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_COMPANIES` | Search LinkedIn Companies | Find LinkedIn companies by name keywords, location, size, or industry and return one controllable result page. This is a provider-scraping read; billing and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_EVENTS` | Search LinkedIn Events | Search LinkedIn events by keywords and return one controllable page. Results may expose organizer names and public event details and this provider-scraping read may consume HarvestAPI credits; billing and account-tier behavior are unverified. |
| `HARVESTAPI_SEARCH_GEO_IDS` | Search LinkedIn Geo IDs | Resolve location text to LinkedIn Geo IDs for precise people and company search filters. This is a provider-scraping read; billing and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_GROUPS` | Search LinkedIn Groups | Search LinkedIn groups by keyword and return one controllable result page. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_JOBS` | 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. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_LEADS` | 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. This provider-scraping operation returns personal identity, employment, and location data. Billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_POSTS` | Search LinkedIn Posts | Search LinkedIn posts by keywords, authors, companies, mentions, content type, group, and date controls, returning one page only. Provider date post-filtering can make pagination metadata and has_more inaccurate. Profile and company author filters may return fewer results; use GET_PROFILE_POSTS or GET_COMPANY_POSTS for complete author feeds. This provider-scraping read may consume credits and returns authored content and identities; billing and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_PROFILES` | Search LinkedIn Profiles | Search public LinkedIn profiles by person, employer, school, title, location, industry, or follower relationship and return one result page. Results can be anonymized. This provider-scraping read returns personal identity, employment, location, and profile URL data; billing, credit use, and tier behavior are unverified. |
| `HARVESTAPI_SEARCH_SERVICES` | Search LinkedIn Services | Search LinkedIn service-provider profiles by service or name keywords and location. This provider-scraping read returns personal identity, position, location, and profile URL data; billing, credit use, and tier behavior are unverified. |
| `HARVESTAPI_SEARCH_TYPEAHEAD` | Search LinkedIn Typeahead | Return LinkedIn search-bar suggestions or one page of company, school, or profile suggestions. Typed searches expose up to 100 results per page and may return personal identity and profile data. This is a provider-scraping read that consumes HarvestAPI credits; exact billing and tier behavior are unverified. |

## Supported Triggers

None listed.

## Troubleshooting

### Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

### Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

### Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing/platform) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### Use HarvestAPI from Atomic Agent
With your account connected, ask Atomic Agent to work with HarvestAPI in natural language. You can connect more apps through the same Composio integration as you need them.
Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build HarvestAPI MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/harvestapi/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/harvestapi/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/harvestapi/framework/hermes-agent)

## Related Toolkits

- [Ashby](https://composio.dev/toolkits/ashby) - Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics.
- [7shifts](https://composio.dev/toolkits/7shifts) - 7shifts is a restaurant team management platform for scheduling, time clocks, payroll, and team communication. It helps operators keep labor, shifts, and staff workflows organized in one place.
- [AI Ark](https://composio.dev/toolkits/ai_ark) - AI Ark is a people and company intelligence platform with search, enrichment, and recruiting APIs. It helps teams find accurate contact data and discover hiring insights faster.
- [Alion](https://composio.dev/toolkits/alion) - Alion is a REST API for company, job, people, investor, market, and hiring intelligence. It helps teams enrich research with structured business and workforce data.
- [Async interview](https://composio.dev/toolkits/async_interview) - Async interview is an on-demand video interview platform for streamlined hiring. Candidates record responses on their schedule, so employers can review anytime.
- [Bamboohr](https://composio.dev/toolkits/bamboohr) - BambooHR is a cloud-based HR management platform for small and mid-sized businesses. It streamlines employee data, HR workflows, and reporting in one easy interface.
- [Breathe HR](https://composio.dev/toolkits/breathehr) - Breathe HR is cloud-based HR software for SMEs to manage employee data, absences, and performance. It simplifies HR admin, making it easy to keep employee records accurate and up to date.
- [Breezy Hr](https://composio.dev/toolkits/breezy_hr) - Breezy HR is a recruiting and applicant tracking platform for managing jobs, candidates, pipelines, and hiring teams. It helps teams move faster from job posting to offer without losing track of applicants.
- [Connecteam](https://composio.dev/toolkits/connecteam) - Connecteam is a workforce management platform for deskless teams, streamlining operations, HR, and team communication. It helps businesses save time by automating scheduling, time tracking, and staff engagement tasks.
- [ContactOut](https://composio.dev/toolkits/contactout) - ContactOut is a professional profile enrichment and contact discovery API. Find and verify email addresses to power recruiting, sales, and outreach.
- [Coresignal](https://composio.dev/toolkits/coresignal) - Coresignal is a real-time public web data platform for employee, company, and professional profile intelligence. It helps teams access fresh workforce data for research, recruiting, sales, and market analysis.
- [Deel](https://composio.dev/toolkits/deel) - Deel is a global payroll and compliance platform for hiring international contractors and employees. It helps businesses pay global teams and manage local employment requirements.
- [Deputy](https://composio.dev/toolkits/deputy) - Deputy is a workforce management platform for scheduling, employees, timesheets, leave, and workplace locations. It helps teams simplify staff planning, time tracking, and daily workforce operations.
- [Dice MCP](https://composio.dev/toolkits/dice_mcp) - Dice MCP is an MCP server for searching Dice's tech-job database by role, company, location, and employment type. It helps agents find relevant tech roles fast with conversational filters.
- [Greenhouse](https://composio.dev/toolkits/greenhouse) - Greenhouse is applicant tracking and recruiting software for managing jobs, candidates, interviews, and hiring workflows. It helps recruiting teams move faster with structured pipelines, collaboration tools, and hiring data in one place.
- [Gusto](https://composio.dev/toolkits/gusto) - Gusto is a payroll, benefits, and HR platform for small and medium businesses. It helps teams run payroll, manage people, and stay compliant with less busywork.
- [HiBob](https://composio.dev/toolkits/hibob) - HiBob is a human resources platform for managing people data, time off, attendance, and workforce planning. It gives HR teams one place to organize employee information and daily people operations.
- [Hireflix](https://composio.dev/toolkits/hireflix) - Hireflix is a one-way video interview platform for hiring teams. It helps teams manage positions, candidate interviews, templates, and branded hiring workflows in one place.
- [HR Partner](https://composio.dev/toolkits/hr_partner) - HR Partner is a human resources platform for managing employee records, leave, recruitment, performance, timesheets, and expenses. Use it to centralize HR workflows, automate manual HR tasks, and keep employee data organized.
- [Job Search (Rapid API)](https://composio.dev/toolkits/job_search) - Job Search (Rapid API) is a unified service that searches approved job-listing sources via RapidAPI hosts. Use it to aggregate and query listings across providers with a single API.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and HarvestAPI MCP?

With a standalone HarvestAPI MCP server, the agents and LLMs can only access a fixed set of HarvestAPI tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from HarvestAPI and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Atomic Agent?

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right HarvestAPI tools.

### Can I manage the permissions and scopes for HarvestAPI while using Tool Router?

Yes, absolutely. You can configure which HarvestAPI scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your HarvestAPI data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
