# Greenhouse MCP for AI Agents AI Agent Connect

> Greenhouse MCP lets you manage your entire recruitment pipeline using natural language. You can move candidates through stages, track job openings, and pull department data without leaving your AI chat. It turns your AI into a dedicated recruiting coordinator that handles the tedious data entry of an ATS.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_QnBhvZKjRXYKmRd8e6z9IUoYxlZX6TfCxC295643/ai-agent-connect
- **Tags:** candidate-tracking, hiring-pipeline, talent-acquisition, interview-management, recruitment-automation, applicant-data

## Description

This Greenhouse MCP puts your entire hiring workflow into a chat interface. Instead of clicking through dozens of tabs to find where a candidate stands or manually updating job statuses, you just ask your agent to do it. You can pull up specific candidate records, move people forward in the pipeline, and check which departments have open roles. It handles the heavy lifting of data management so you can focus on actually talking to people. By connecting this to your workspace via Vinkius, you get a way to run your ATS without the constant context switching. It is about moving from searching for data to making decisions based on data. You can quickly see who is in the pipeline, update their information, and keep your team's hiring goals on track. You no longer have to worry about the friction of manual entry. If you need to know who is in the technical interview stage or what the current office capacity looks like, the agent gives you the answer in seconds. This means you spend less time in a browser and more time on the human side of recruiting. Sourcers looking for a specific person or managers checking on a team's progress can use this connection to remove the friction of the dashboard. It works by pulling the raw data from Greenhouse and presenting it in a way that makes sense for your conversation. You get to stop being a data entry clerk and start being a recruiter again. This is how you actually scale your hiring without adding more administrative overhead to your day.

## Tools

### create_candidate
Add a new candidate to your pipeline with their name and company. This saves you from manual data entry when sourcing new leads.

### get_candidate_details
Pull specific info for a candidate to see their history and current status. Use this to quickly check a resume without opening the full ATS page.

### get_job_details
Get the metadata for a specific job opening to see who is hiring for it. This helps you understand the internal structure of a role.

### list_applications
See a full list of applications for a specific role. Use this to monitor the volume of interest for your active listings.

### list_candidates
View all candidates currently in your recruitment pipeline. This gives you a birds-eye view of your current talent pool.

### list_departments
Get a list of all company departments to coordinate internal hiring. Use this to see how different teams are structured.

### list_open_jobs
See every active job opening currently listed in Greenhouse. This is perfect for checking total headcount across the company.

### list_offices
Get a list of all office locations for recruitment logistics. Use this to coordinate where new hires will be based.

### reject_application
Move an application to a rejected status with a specific reason. This keeps your pipeline clean and updated in real time.

### update_candidate
Modify existing candidate information like titles or current employers. Use this to keep your records accurate as people move jobs.

### advance_application
Push a candidate to the next stage of the hiring process. This allows you to update statuses instantly from a chat window.

### get_api_status
Check if your Greenhouse account is properly connected to the agent. Use this to troubleshoot any connection issues quickly.

## Prompt Examples

**Prompt:** 
```
Find the candidate with the email 'j.doe@example.com' and tell me where they are in the process.
```

**Response:** 
```
I found a candidate with that email. They are currently in the **Technical Assessment** stage for the **Software Engineer** role.

Would you like me to:
* Advance them to the next stage?
* Pull their full contact history?
* See the specific job requirements?
```

**Prompt:** 
```
How many open roles do we have in the Marketing department?
```

**Response:** 
```
I'm checking the current openings... You have **3 active roles** in Marketing:

| Role | Status |
| :--- | :--- |
| Content Strategist | Open |
| SEO Specialist | Open |
| Growth Lead | Open |

I can provide more details on any of these.
```

**Prompt:** 
```
Move application app_772 to the next stage.
```

**Response:** 
```
Done. I've moved application **app_772** to the **Onsite Interview** stage. The hiring team will be notified of the update in Greenhouse.
```

## Capabilities

### Move candidates through hiring stages
Use your agent to push candidates to the next step in your recruitment process.

### Pull specific candidate profiles
Get contact info and professional history for any candidate in your pipeline.

### List all current job openings
See every active role and its metadata across your entire organization.

### Add new candidates to the system
Create new candidate records with names and company info via natural language.

### Check company department lists
Retrieve a full list of departments and office locations for logistics.

### Update candidate information
Modify existing records like job titles or current employers on the fly.

### Monitor API connectivity
Check your Greenhouse account status to ensure your agent has active access.

## Use Cases

### Moving a candidate forward
A recruiter finishes a phone screen and asks the agent to use `advance_application` to move the candidate to the interview stage.

### Checking team capacity
A manager asks the agent to use `list_open_jobs` to see how many Engineering roles are still open.

### Quick candidate lookup
A sourcer finds a lead and asks the agent to use `create_candidate` to put them into the system immediately.

### Handling rejections
An HR lead asks the agent to use `reject_application` for a candidate who didn't meet the requirements.

## Benefits

- Stop manual status updates by using `advance_application` to move people through the pipeline instantly.
- Get instant candidate profiles using `get_candidate_details` without opening a new browser tab.
- Keep your team informed on hiring capacity by quickly pulling data with `list_open_jobs`.
- Reduce data entry errors by using `create_candidate` and `update_candidate` to keep records fresh.
- Coordinate logistics faster by pulling office and department data with `list_offices` and `list_departments`.
- Monitor your connection health easily with `get_api_status` to ensure your agent always has access.

## How It Works

The bottom line is you get a conversational interface for your Greenhouse ATS that handles the manual data entry for you.

1. Subscribe to the Greenhouse MCP on Vinkius.
2. Grab your Harvest API Key from the Greenhouse Dev Center.
3. Provide a valid User ID to allow the agent to act on your behalf.

## Frequently Asked Questions

**Can the Greenhouse MCP move candidates through the hiring stages for me?**
Yes. You can tell your agent to advance a candidate to the next step, and it will update the status in Greenhouse automatically.

**How do I connect my Greenhouse account to the AI?**
You'll need your Harvest API Key from the Greenhouse Dev Center. Once you have that and a User ID, you can link it through Vinkius.

**Can I use this to see which departments have open jobs?**
Yes, the Connector can list all active job openings and your company departments so you can see the full hiring landscape.

**Will the AI be able to reject candidates for me?**
It can, as long as you provide the reason for the rejection. You just tell the agent to reject the application and give it the necessary reason.

**Does this Connector work with Claude or Cursor?**
Yes, it works with any MCP-compatible client like Claude, Cursor, or Windsurf.

**Can I add new candidates to Greenhouse using natural language?**
You can. Just give your agent the candidate's name and company, and it will create the record for you.

**What is the 'On-Behalf-Of' requirement?**
Greenhouse requires write operations to be associated with a specific User ID for auditing. This ID is passed in the header to identify who performed the action.

**Can I search for candidates by email?**
Yes! Use the `list_candidates` tool and provide the `email` parameter to find a specific person's recruitment record and history.

**How do I advance an application to the next stage?**
The `advance_application` tool requires a valid application ID. It will automatically move the candidate to the next sequential stage defined in your job's workflow.