How to integrate Greenhouse MCP with Codex

Connect Codex to Greenhouse MCP. List open greenhouse candidate applications, summarize new candidates for engineering, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Greenhouse

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

Managed auth

Connect Greenhouse without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Try for free

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Greenhouse MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate Greenhouse with

Claude Cowork

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
Large tool responses: Handle them to minimise context rot.
Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Greenhouse MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash

codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash

codex mcp list

Codex App

Codex App follows the same approach as VS Code.

Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
The Key is the Composio API key, that you can find on dashboard.composio.dev
Click on Authenticate and authorize Codex to your Composio account and you're all set.

Restart and verify if it's there in .codex/config.toml

bash

[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

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

The Greenhouse MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Greenhouse account. It provides structured and secure access so your agent can perform Greenhouse operations on your behalf.

Conclusion

You've successfully integrated Greenhouse with Codex using Composio's MCP server. Now you can interact with Greenhouse directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

Seamless integration across CLI, VS Code, and standalone app
Natural language commands for Greenhouse operations
Managed authentication through Composio
Access to 20,000+ tools across 1000+ apps for cross-app workflows
CodeAct workbench for complex tool chaining

Next steps:

Try asking Codex to perform various Greenhouse operations
Explore cross-app workflows by connecting more toolkits
Build automation scripts that leverage Codex's AI capabilities

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.

FRAMEWORKS

How to build Greenhouse MCP Agent with another framework

Claude Cowork

Use Greenhouse MCP with Claude Cowork

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Ashby

Api Key

Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics.

Async interview

Api Key

Async interview is an on-demand video interview platform for streamlined hiring. Candidates record responses on their schedule, so employers can review anytime.

Bamboohr

Oauth2Api Key

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

Api Key

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.

FAQ

Frequently asked questions

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

Yes, you can. Codex 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 Greenhouse tools.

Yes, absolutely. You can configure which Greenhouse 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.

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 Greenhouse data and credentials are handled as safely as possible.

Start with Greenhouse.It takes 30 seconds.

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

Start building

Customer stories

Teams ship real agents on Composio

GET STARTED FOR FREE BOOK A DEMO

Karan skipped his own birthday party to fix our critical issue. It was 10pm and he diverted his Waymo to help us instead. This really sets the bar — it shows the commitment you need when users rely on your software.

Harsha Gaddipati

Co-founder, Slashy

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it's immensely helped keep new users on the platform.

Abhi Arya

Co-founder, Opennote

We chose Composio over Pipedream because it delivered depth where it mattered — niche tools and tricky edge cases other platforms simply ignored. That gave us confidence to scale without compromising.

Nirman Dave

CEO, Zams

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down managing agent auth would have been a death sentence.

Ryan Yu

Founder, Extra Thursday

Before Composio, adding tool integrations was slow and resource-intensive. Each one could take weeks of engineering time, and maintaining them meant constantly keeping up with API changes.

Tomisin Jenrola

Founder & CEO, SwarmZero

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Jerome Leclanche

Co-Founder, Ingram Technologies

How to integrate Greenhouse MCP with Codex

Connect Greenhouse without auth hassles

Introduction

Also integrate Greenhouse with

Why use Composio?

How to install Greenhouse MCP in Codex

Run the setup command

(Optional) Authenticate with OAuth

Verify the connection

Codex App

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

Conclusion

Supported Tools

How to build Greenhouse MCP Agent with another framework

Claude Cowork

Explore Other Toolkits

Ashby

Async interview

Bamboohr

Breathe HR

Frequently asked questions

What are the differences in Tool Router MCP and Greenhouse MCP?+

Can I use Tool Router MCP with Codex?+

Can I manage the permissions and scopes for Greenhouse while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Greenhouse.It takes 30 seconds.

Teams ship real agents on Composio