Greenhouse MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Greenhouse MCP or direct API to list candidates, review applications, manage jobs, and track interview pipelines through natural language.

Greenhouse logoGreenhouse
Api KeyS2s Oauth2Oauth2

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.

133 Tools

Try Greenhouse now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Greenhouse
Try asking
TOOLS

Supported Tools

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

Reactivate Greenhouse user

Reactivate a previously deactivated Greenhouse user via the Harvest v3 API so they can sign in again.

Anonymize Greenhouse candidate

Tool to anonymize selected categories of personally identifiable data on a Greenhouse candidate via the Harvest v3 API, for GDPR or right-to-be-forgotten requests.

Apply Greenhouse candidate tag

Tool to apply an existing candidate tag to a candidate via the Greenhouse Harvest v3 API.

Bulk create Greenhouse blocked spam sources

Tool to add multiple blocked spam sources to Greenhouse in a single request via the Harvest v3 API.

Bulk create Greenhouse custom field options

Tool to add many custom field options at once to select-type custom fields via the Greenhouse Harvest v3 API.

Bulk create Greenhouse openings

Tool to asynchronously create many Greenhouse openings across one or more jobs in a single Harvest v3 call.

Bulk deactivate Greenhouse users

Tool to asynchronously deactivate many Greenhouse users in a single Harvest v3 call, up to the bulk-endpoint cap per request.

Bulk delete Greenhouse custom field options

Tool to archive many custom field options at once by id via the Greenhouse Harvest v3 API.

Bulk update Greenhouse blocked spam sources

Tool to asynchronously update the note on many Greenhouse blocked spam sources in a single Harvest v3 call.

Bulk update Greenhouse custom field options

Tool to asynchronously edit many Greenhouse custom field options in a single Harvest v3 call.

Bulk update Greenhouse departments

Tool to asynchronously update many Greenhouse departments in a single call via the Harvest v3 API.

Bulk update Greenhouse offices

Tool to asynchronously update many Greenhouse offices in a single Harvest v3 call.

Bulk update Greenhouse openings

Tool to asynchronously update many Greenhouse openings in a single call via the Harvest v3 API.

Bulk update Greenhouse users

Tool to asynchronously update many Greenhouse users in a single call via the Harvest v3 API.

Create Greenhouse application

Tool to create a new application for an existing Greenhouse candidate via the Harvest v3 API.

Create Greenhouse approval flow

Tool to create a multi-step approval flow on a Greenhouse job via the Harvest v3 API.

Create Greenhouse attachment

Tool to attach a file to an existing Greenhouse application via the Harvest v3 API.

Create Greenhouse blocked spam source

Tool to add a new IP address, CIDR range, email address, or email domain to the organization's spam blocklist via the Greenhouse Harvest v3 API.

Create Greenhouse candidate

Tool to create a new candidate profile in Greenhouse via the Harvest v3 API.

Create Greenhouse candidate education

Tool to add a new education entry to a Greenhouse candidate's profile via the Harvest v3 API.

Create Greenhouse candidate employment

Tool to add a new work-history (employment) entry to a Greenhouse candidate's profile via the Harvest v3 API.

Create Greenhouse candidate tag

Tool to add a new tag to the organization's candidate-tag dictionary via the Greenhouse Harvest v3 API.

Create Greenhouse custom field

Tool to add a new custom field to your organization's dictionary via the Greenhouse Harvest v3 API.

Create Greenhouse custom field department

Tool to restrict a custom field's visibility to one additional department via the Greenhouse Harvest v3 API.

Create Greenhouse custom field office

Tool to restrict a custom field's visibility to one additional office via the Greenhouse Harvest v3 API.

Create Greenhouse custom field option

Tool to add a new selectable value to a single_select or multi_select custom field via the Greenhouse Harvest v3 API.

Create Greenhouse department

Tool to create a new department for the organization via the Greenhouse Harvest v3 API.

Create Greenhouse interview

Tool to create a scheduled interview against a candidate application in Greenhouse Harvest.

Create Greenhouse job

Tool to create a new Greenhouse job from an existing template via the Harvest v3 API.

Create Greenhouse job hiring manager

Tool to assign a user as a hiring manager on a Greenhouse job via the Harvest v3 API.

Create Greenhouse job note

Tool to create a free-form note attached to a Greenhouse job via the Harvest v3 API.

Add Greenhouse job owner

Add a Greenhouse user to a job's hiring team as a recruiter, sourcer, or coordinator via the Harvest v3 API.

Create Greenhouse candidate note

Tool to create a candidate note, log an email, or record an activity-feed entry on a Greenhouse candidate via the Harvest v3 API.

Create Greenhouse offer

Tool to create a new offer on an existing Greenhouse application via the Harvest v3 API.

Create Greenhouse office

Tool to create a new office for the organization via the Greenhouse Harvest v3 API.

Create Greenhouse opening

Tool to add a new opening (headcount slot) to an existing Greenhouse job via the Harvest v3 API.

Create Greenhouse user

Create a new user in your Greenhouse Recruiting organization via the Harvest v3 API.

Create Greenhouse user email

Attach an additional email address to an existing Greenhouse user via the Harvest v3 API.

Grant Greenhouse user job permission

Grant a Greenhouse user a Job Admin role on a single job via the Harvest v3 API.

Deactivate Greenhouse user

Tool to deactivate a Greenhouse user via the Harvest v3 API, preventing that user from signing in while preserving their historical data.

Delete Greenhouse application

Tool to permanently delete a single Greenhouse application via the Harvest v3 API, along with its interview stages, scorecards, rejection details, and prospect details.

Delete Greenhouse applied candidate tag

Tool to detach a single tag from a candidate in Greenhouse via the Harvest v3 API, identified by its applied candidate tag id.

Delete Greenhouse attachment

Tool to permanently remove an attachment from its Greenhouse application via the Harvest v3 API, identified by its attachment id.

Delete Greenhouse blocked spam source

Tool to permanently remove a single blocked spam source from Greenhouse via the Harvest v3 API.

Delete Greenhouse candidate

Tool to permanently delete a candidate from Greenhouse via the Harvest v3 API.

Delete Greenhouse candidate education

Tool to remove a single education entry from a Greenhouse candidate's profile via the Harvest v3 API.

Delete Greenhouse candidate employment

Tool to permanently delete a single employment entry from a candidate's profile in Greenhouse via the Harvest v3 API.

Delete Greenhouse candidate tag

Tool to delete a tag from your organization's candidate-tag dictionary in Greenhouse via the Harvest v3 API, identified by its candidate tag id.

Delete Greenhouse custom field office

Tool to remove an office from a custom field's visibility scope via the Greenhouse Harvest v3 API.

Delete Greenhouse custom field option

Tool to archive a single custom field option via the Greenhouse Harvest v3 API so it can no longer be selected on new records.

Delete Greenhouse interview

Tool to cancel and permanently delete a scheduled interview in Greenhouse via the Harvest v3 API, identified by its interview id.

Delete Greenhouse job hiring manager

Unassign a hiring manager from a Greenhouse job by deleting the job hiring manager join row, identified by its id, via the Harvest v3 API.

Delete Greenhouse job note

Permanently delete a Greenhouse job note, identified by its id, via the Harvest v3 API.

Delete Greenhouse job owner

Remove a Greenhouse user from a job's hiring team in a single role by deleting the job owner join row, identified by its id, via the Harvest v3 API.

Delete Greenhouse user job permission

Tool to revoke a single Greenhouse user job permission by its id via the Harvest v3 API, removing that user's Job Admin role on the associated job.

Hire Greenhouse application

Tool to mark a Greenhouse application as hired and close out the matching opening on the job via the Harvest v3 API.

List Greenhouse applications

List the applications in your Greenhouse organization, which associate candidates with jobs (candidate applications attach to exactly one job; prospect applications attach to zero or more).

List Greenhouse application stages

List the application stage history rows in your Greenhouse organization — one row per interview stage an application has occupied, with entered_at and exited_at timestamps.

List Greenhouse approval flows

Tool to list the approval flows in a Greenhouse organization via the Harvest v3 API.

List Greenhouse approver groups

Tool to list the approver groups in a Greenhouse organization via the Harvest v3 API.

List Greenhouse approvers

Tool to list approver records in a Greenhouse organization via the Harvest v3 API.

List Greenhouse attachments

List the attachments in your Greenhouse organization, which are files associated with applications such as resumes, cover letters, take-home tests, offer documents, and e-signed agreements.

List Greenhouse bulk requests

List the asynchronous bulk requests submitted to Greenhouse Harvest v3, each tracking a batch operation with its record, success, and failure counts and current status.

List Greenhouse candidate educations

Tool to list candidate educations in a Greenhouse organization via the Harvest v3 API.

List Greenhouse candidate employments

Tool to list candidate employments in a Greenhouse organization via the Harvest v3 API.

List Greenhouse candidates

List the candidates (active applicants and prospects) in your Greenhouse organization, returning each candidate's profile: names, contact methods, tags, custom fields, and timestamps.

List Greenhouse candidate tags

Tool to list the candidate tags configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse close reasons

Tool to list the close reasons configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse custom field departments

Tool to list the custom field department associations configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse custom field offices

Tool to list the custom_field_office associations in a Greenhouse organization via the Harvest v3 API.

List Greenhouse custom field options

Tool to list the custom field options configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse custom fields

Tool to list the custom field definitions configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse default interviewers

List the default interviewers configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse demographic answer options

Tool to list all of a Greenhouse organization's demographic answer options via the Harvest v3 API.

List Greenhouse demographic answers

Tool to list all of a Greenhouse organization's demographic answers via the Harvest v3 API.

List Greenhouse demographic questions

Tool to list the demographic questions configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse demographic question sets

Tool to list all of a Greenhouse organization's demographic question sets via the Harvest v3 API.

List Greenhouse departments

Tool to list the departments configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse EEOC responses

Tool to list EEOC self-identification responses in a Greenhouse organization via the Harvest v3 API.

List Greenhouse email templates

Tool to list the email templates configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse focus candidate attributes

List the focus candidate attributes in your Greenhouse organization — the subset of a job's job_candidate_attributes that an interview kit elevates as focus areas at the top of the interviewer's scorecard.

List Greenhouse interviewer tags

List the interviewer tags in your Greenhouse organization: the organization-defined labels that can be assigned to interviewer users (for example "Phone Screener" or "Culture Add Interviewer").

List Greenhouse interview kits

Tool to list the interview kits (per-job, per-slot evaluation packets interviewers see when conducting an interview) in a Greenhouse organization via the Harvest v3 API.

List Greenhouse interviews

Tool to list scheduled interview events in a Greenhouse organization via the Harvest v3 API.

List Greenhouse job board custom locations

Tool to list a Greenhouse organization's job board custom locations via the Harvest v3 API.

List Greenhouse job boards

Tool to list the job boards configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse job candidate attributes

Tool to list the job candidate attributes (the per-job instances of a job's candidate_attribute_types) in a Greenhouse organization via the Harvest v3 API.

List Greenhouse job hiring managers

List the job hiring managers configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse job interviews

Tool to list the interview slot template definitions configured on jobs' interview plans in a Greenhouse organization via the Harvest v3 API.

List Greenhouse job interview stages

List the job interview stages in your Greenhouse organization — the steps that make up each job's interview plan (e.

List Greenhouse job notes

List the free-form, organization-internal notes attached to jobs across your Greenhouse organization.

List Greenhouse job owners

List the job owners across your Greenhouse organization.

List Greenhouse job posts

List the candidate-facing job posts in your Greenhouse organization.

List Greenhouse job post searchable locations

List the searchable geographic locations attached to job posts in your Greenhouse organization.

List Greenhouse jobs

List the jobs (hiring plans) in your Greenhouse organization.

List Greenhouse notes

Tool to list the notes (free-form activity-feed entries) across a Greenhouse organization via the Harvest v3 API.

List Greenhouse offers

Tool to list the offers in a Greenhouse organization via the Harvest v3 API.

List Greenhouse offices

Tool to list the offices configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse openings

List the openings (individual headcount slots beneath jobs) in your Greenhouse organization.

List Greenhouse pay input ranges

Tool to list the pay input ranges configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse pay inputs

Tool to list the pay inputs in a Greenhouse organization via the Harvest v3 API.

List Greenhouse prospect pools

Tool to list the prospect pools configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse prospect pool stages

Tool to list the prospect pool stages configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse referrers

List the referrers in your Greenhouse organization.

List Greenhouse rejection details

Tool to list the per-application rejection records in a Greenhouse organization via the Harvest v3 API.

List Greenhouse rejection reasons

Tool to list the rejection reasons configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse scorecard question options

Tool to list scorecard question options - the multiple-choice values shown to interviewers for single_select and multi_select scorecard questions - in a Greenhouse organization via the Harvest v3 API.

List Greenhouse scorecards

Tool to list the scorecards (per-interview evaluations) in a Greenhouse organization via the Harvest v3 API.

List Greenhouse sources

Tool to list the sources configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse tracking links

Tool to list the tracking links configured in a Greenhouse organization via the Harvest v3 API.

List Greenhouse user job permissions

List the per-user, per-job access grants in your Greenhouse organization, each pairing a user with a Job Admin role on a specific job.

List Greenhouse users

List the user accounts (recruiters, hiring managers, interviewers, coordinators, and site admins) in your Greenhouse organization.

Merge Greenhouse candidates

Tool to merge two candidate profiles in Greenhouse via the Harvest v3 API, collapsing a secondary (duplicate) candidate into a primary one.

Move Greenhouse application

Tool to move a Greenhouse application to a different interview stage via the Harvest v3 API.

Reject Greenhouse application

Tool to reject an existing Greenhouse application via the Harvest v3 API, recording the rejection reason and optionally notifying the candidate.

Replace Greenhouse approver

Tool to swap one approver in a Greenhouse approver group for another user via the Harvest v3 API, without rebuilding the rest of the approval flow.

Request Greenhouse approvals

Tool to start an existing pending Greenhouse approval flow by emailing its initial approver(s) via the Harvest v3 API.

Revoke Greenhouse user permissions

Revoke a Greenhouse user's site admin permissions via the Harvest v3 API, reverting them to a Basic user.

Search Greenhouse applications

Search applications through Greenhouse's full-text candidate search index with richer pipeline filters than the plain list endpoint.

Update Greenhouse application

Tool to update attribution and metadata on an existing Greenhouse application via the Harvest v3 API.

Update Greenhouse approval flow

Tool to toggle whether a Greenhouse approval flow resolves sequentially or in parallel, via the Harvest v3 API.

Update Greenhouse blocked spam source

Tool to update the note on an existing entry in the organization's spam blocklist via the Greenhouse Harvest v3 API.

Update Greenhouse candidate

Tool to update an existing candidate's profile in Greenhouse via the Harvest v3 API.

Update Greenhouse custom field

Tool to edit the definition of an existing Greenhouse custom field via the Harvest v3 API.

Update Greenhouse custom field option

Tool to edit the display label, sort order, or external id of an existing custom field option via the Greenhouse Harvest v3 API.

Update Greenhouse department

Tool to update an existing Greenhouse department via the Harvest v3 API.

Update Greenhouse interview

Tool to update a scheduled Greenhouse interview via the Harvest v3 API.

Update Greenhouse job

Tool to update an existing Greenhouse job's editable fields via the Harvest v3 API.

Update Greenhouse job note

Update an existing Greenhouse job note, identified by its id, via the Harvest v3 API.

Update Greenhouse office

Tool to update an existing office for the organization via the Greenhouse Harvest v3 API.

Update Greenhouse opening

Tool to edit an existing opening (headcount slot) on a Greenhouse job via the Harvest v3 API, or close/reopen it.

Update Greenhouse rejection detail

Tool to patch the rejection reason and/or rejection-question custom field answers on a rejected application's rejection detail record via the Greenhouse Harvest v3 API.

Update Greenhouse user

Tool to update an existing user's profile in Greenhouse via the Harvest v3 API.

SETUP GUIDE

Connect Greenhouse MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Greenhouse
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Find Greenhouse candidates in interview stage and summarize their next steps'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Greenhouse API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Greenhouse Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List all open Greenhouse jobs and show candidates added this week'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Greenhouse actions with your Agent

Why Use Composio?

AI Native Greenhouse Integration

  • Supports both Greenhouse MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable recruiting workflow execution
  • Rich coverage for reading, writing, and querying Greenhouse jobs, candidates, applications, and interviews

Managed Auth

  • Secure handling for Greenhouse API keys, OAuth, and service-to-service OAuth flows
  • Central place to manage, scope, and revoke Greenhouse access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear Greenhouse tool schemas help agents understand jobs, candidates, applications, and hiring stages
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Greenhouse
  • Scoped, least privilege access to Greenhouse recruiting data
  • Full audit trail of agent actions to support hiring review and compliance
FRAMEWORKS

Use Greenhouse with any AI Agent Framework

Choose a Framework you want to connect Greenhouse with

FAQ

Frequently asked questions

Yes, Greenhouse requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Greenhouse.It takes 30 seconds.

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

Start building