# Greenhouse MCP for AI Agents AI Agent Connect

> Greenhouse MCP. Manage your recruiting pipeline, track candidate activity, and handle job board posts directly from your AI agent. Stop switching tabs between your ATS and your workspace to keep your hiring on track.

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

## Description

You're tired of jumping between Greenhouse and your chat app just to see if a candidate moved to the next stage. This Connector puts your recruiting data right where you're already working. Instead of digging through folders, you can just ask your agent for a status update. You can check candidate activity feeds, pull job details, or update applications without ever leaving your conversation. It's part of the Vinkius catalog, which means you can plug it in and get straight to the work of finding and hiring great people. You can pull full application details or see what jobs are live on your boards with a simple request. It handles the heavy lifting of data retrieval so you can focus on the actual conversations that matter.

## Tools

### get_api_status
Get account connectivity

### get_candidate_details
Get candidate info

### get_job_details
Get job metadata

### list_candidates
List recruitment candidates

### advance_application
Move candidate to next stage

### create_candidate
Can include first name, last name, and company.

Add new candidate

### list_departments
List company departments

### list_open_jobs
List active job openings

### list_offices
List office locations

### reject_application
Requires a reason ID.

Reject job application

### update_candidate
Modify candidate info

### list_applications
Get a full list of all applications in Greenhouse. Use it to see your entire hiring volume at once.

## Prompt Examples

**Prompt:** 
```
Who applied for the Software Engineer role last week?
```

**Response:** 
```
I've pulled the recent applications for the **Software Engineer** position. Here are the latest entries:

| Candidate Name | Application Date | Status |
| :--- | :--- | :--- |
| Jane Doe | Oct 24, 2023 | Technical Interview |
| John Smith | Oct 23, 2023 | Reviewing |

Would you like me to pull the full details for any of these?
```

**Prompt:** 
```
Give me a summary of Jane Doe's progress.
```

**Response:** 
```
Here is the latest activity for **Jane Doe**:

* **Oct 25:** Completed Technical Interview.
* **Oct 23:** Status changed to 'Offer Pending'.
* **Oct 20:** Initial screening completed.

She is currently in the final stages of the hiring process.
```

**Prompt:** 
```
What jobs do we have in the NYC office?
```

**Response:** 
```
I found the following active jobs for the **New York City** office:

* Senior Backend Developer
* UI/UX Designer
* DevOps Engineer

Let me know if you want to see the specific job boards for any of these.
```

## Capabilities

### Retrieve candidate history
Get the full activity feed for any candidate to see their entire journey.

### Update application status
Change candidate records and move them through your pipeline instantly.

### Audit hiring logs
See exactly who changed what in your Greenhouse account and when.

### Manage job boards
List published jobs and submit new applications to your boards automatically.

### Sync partner leads
Pull candidate status and job listings from your partner connections.

## Use Cases

### Checking candidate status during a call
A recruiter is on a call and asks their agent to show the activity feed for a specific candidate using get_candidate_activity_feed.

### Reviewing job board posts
A hiring manager wants to see what's live in the tech department and uses list_board_jobs to get the list.

### Bulk application updates
An HR specialist needs to update several applications at once and uses update_application to move them to the next stage.

### Ingesting partner leads
A sourcer gets a new lead from a partner and uses submit_partner_candidate to put them directly into the system.

## Benefits

- Get candidate history instantly using get_candidate_activity_feed to prepare for interviews.
- Update application statuses on the fly with update_application without leaving your workspace.
- See your entire hiring volume at once by using list_applications for a high-level view.
- Automate your job board submissions with submit_board_application to save manual entry time.
- Maintain a clean database by using delete_application to remove duplicates or errors quickly.
- Track your sourcing success with create_partner_tracking_link to see where leads originate.

## How It Works

The bottom line is you get your Greenhouse data inside your favorite chat interface.

1. Connect your Greenhouse account by providing your API token.
2. Connect the Connector to your AI client like Claude or Cursor.
3. Ask your agent to list applications, check candidate status, or update records.

## Frequently Asked Questions

**How does the Greenhouse MCP help my recruiting team?**
It lets your team interact with your recruiting data using natural language. You can check candidate statuses, view activity feeds, and update applications directly from your chat client, which saves time on manual data entry.

**Can I use the Greenhouse MCP to update candidate statuses?**
Yes. You can ask your agent to update an application's status or details, and it will sync those changes directly back to your Greenhouse account.

**Does the Greenhouse MCP support job board management?**
It does. You can use it to list published jobs, see which offices they are in, and even submit new applications to your job boards via your agent.

**Is the Greenhouse MCP good for tracking candidate history?**
It's perfect for that. You can quickly pull a full activity feed for any candidate to see every interaction and status change they've had in your pipeline.

**Can I use the Greenhouse MCP to audit my hiring logs?**
Yes, you can retrieve audit log events to see who made specific changes in your Greenhouse account and when those actions occurred.

**What is the difference between this and just using the Greenhouse website?**
This Connector brings the data to you. Instead of navigating the Greenhouse UI, you stay in your chat workspace and get the specific information you need through a conversation.

**Can I see the history of interactions with a specific candidate?**
Yes, you can use the `get_candidate_activity_feed` tool with a candidate's ID to retrieve their full activity history, including notes and status changes.

**How do I list all open positions on our job board?**
Use the `list_board_jobs` tool providing your job board token. This will return all active job posts currently published.

**Is it possible to update application details directly through the AI?**
Yes, the `update_application` tool allows you to modify existing application fields by providing the application ID and the data payload.

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