# Greenhouse MCP

> Greenhouse lets your AI agent manage every step of your hiring pipeline from a single chat window. You can list and get details on applications, track candidate activity feeds, and even submit job posts or new candidates—all without leaving your workflow. It's the full control panel for recruiters who hate switching tabs.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** recruiting, applicant-tracking, hiring-pipeline, candidate-management, hr-tech

## Description

Managing talent acquisition used to mean logging into dozens of different dashboards just to check a status update. Now, you can talk to your AI client and get everything done in one conversation. This MCP connects directly to Greenhouse so your agent handles candidate record maintenance, job posting visibility, and application tracking automatically.

Need to know what happened with Candidate X? Your agent pulls the complete activity feed instantly. Need to update a status or add new information to an old profile? Just ask. Whether you're working in VS Code, Cursor, or Claude, your agent uses Vinkius to handle all the messy backend work. It keeps your data clean and up-to-date, letting you focus on interviewing people instead of managing databases.

## Tools

### list_board_departments
Lists every department that has published jobs and what those departments are called.

### list_board_jobs
Retrieves a list of all currently active job posts across the entire board.

### list_board_offices
Lists every physical office location and what jobs are associated with it.

### list_partner_jobs
Shows a list of job openings that are visible to external partner users.

### submit_board_application
Submits a candidate's application directly through the job board API key credentials.

### submit_partner_candidate
Sends new candidates or prospects into the Greenhouse system for tracking.

### update_application
Modifies specific details on an existing application record, like changing a status or adding notes.

### add_application_to_candidate
Attaches a new application record to an existing candidate profile.

### create_partner_tracking_link
Generates a unique link for job sourcing that tracks the source of the lead.

### delete_application
Removes a specific candidate application record from the system.

### get_application
Retrieves all details for one single, specified job application.

### get_audit_log_events
Pulls a list of recent system and user activity log events.

### get_board_job
Fetches the full details, including questions, for one specific job post.

### get_candidate_activity_feed
Retrieves a complete timeline of all recorded actions and status changes for a candidate.

### get_partner_candidates
Gets the current status of candidates who came through partner channels.

### list_applications
Provides a list containing basic information for all active applications in Greenhouse.

## Prompt Examples

**Prompt:** 
```
List all current applications in Greenhouse.
```

**Response:** 
```
I've retrieved the applications. You have 12 active applications, including 'Software Engineer' for Jane Doe and 'Product Manager' for John Smith. Would you like details on a specific one?
```

**Prompt:** 
```
Show me the activity feed for candidate ID 98765.
```

**Response:** 
```
Fetching activity for candidate 98765... The latest activities include a 'Technical Interview' completed yesterday and a status change to 'Offer Pending'.
```

**Prompt:** 
```
What are the job posts currently listed on the 'tech-careers' board?
```

**Response:** 
```
I found 3 active posts on the 'tech-careers' board: Senior Backend Developer, UI/UX Designer, and DevOps Engineer. Do you need the full details for any of these?
```

## Capabilities

### View all job board listings
The MCP can list every published job post across various departments or offices.

### Track a candidate's history
It retrieves the complete, chronological activity feed for any specific candidate ID.

### Manage application records
The MCP allows you to pull details on existing applications or delete outdated entries from candidate profiles.

### Submit new job applications
It can submit an application directly to a specific job board using required credentials.

### Add records and candidates
You can add applications to existing candidate profiles or submit entirely new prospects and candidates into the system.

## Use Cases

### Quickly verifying a candidate's status
A recruiter needs to know if Candidate Smith has completed all interviews. They ask their agent to run `get_candidate_activity_feed` for Smith. The agent immediately returns the latest steps, showing the technical interview was finished yesterday and an offer is pending.

### Posting jobs across multiple departments
A hiring manager needs a list of all open roles to review with their team. They ask the agent to run `list_board_jobs`, which quickly compiles all active posts from every department, saving them from navigating separate departmental pages.

### Handling new external leads
A sourcing specialist gets a promising lead through a partner network. They tell their agent to run `submit_partner_candidate`, and the MCP handles the data formatting and submission, keeping Greenhouse updated instantly.

### Cleaning up old application records
An HR ops specialist finds an application that is totally irrelevant or outdated. Instead of manually deleting it in the backend, they ask the agent to use `delete_application` on the specific record ID for clean data maintenance.

## Benefits

- You stop toggling tabs. Instead of opening a separate dashboard just to see if Jane Doe moved status, you ask for the `get_candidate_activity_feed` and get the whole story in one response.
- Running a report on all applicants is instant. Use `list_applications` to pull bulk data or use `list_board_jobs` to check what's open without manually visiting every department page.
- When you find a great candidate from a partner source, you don't need manual entry. You just call `submit_partner_candidate`, and the record is clean and ready to go.
- Need to update something? Instead of finding the right form, you use `update_application` directly through your agent conversation, changing statuses or adding notes instantly.
- You can even create specialized links for sourcing by calling `create_partner_tracking_link`. This ensures every lead is tracked back to its source.

## How It Works

The bottom line is that you never have to manually log into the Greenhouse website again; your AI client handles it all.

1. First, subscribe to this MCP and provide your Greenhouse API Token.
2. Next, call any function through your AI client (like Claude or Cursor) telling it exactly what you need done—e.g., 'List all applications for the Engineering department.'
3. Finally, the agent executes the request against Greenhouse and returns structured data directly to your chat window.

## Frequently Asked Questions

**How do I use the add_application_to_candidate tool in Greenhouse?**
You tell your agent that you want to attach a new application and provide the necessary IDs. The MCP handles sending the data through the API, ensuring the record links correctly to the existing candidate.

**Does list_board_jobs show all current job openings on Greenhouse?**
Yes, it lists every active job post across your entire board. This is useful because you can get a full overview without checking department by department.

**How do I check the history of a candidate using get_candidate_activity_feed?**
Simply ask the agent to retrieve the activity feed for that specific candidate ID. It returns a detailed, chronological list of every status change and interaction recorded.

**Can I submit job applications with the MCP? (submit_board_application)**
Yes, you can use `submit_board_application` if your agent has the required Job Board API Key credential. You just need to provide the target board and application details.

**How do I use the list_applications tool to view my candidate pipeline?**
The list_applications tool retrieves a full summary of all applications in your Greenhouse account. You can get key details like the job title, status, and associated candidate name for quick overviews.

**What information does the get_audit_log_events tool provide?**
This tool pulls detailed audit log events for your organization's Greenhouse usage. It helps you track who made changes to records and when those actions occurred, improving accountability.

**How do I update existing candidate data using the update_application tool?**
You use the update_application tool by providing the necessary application ID and the specific fields you want to change. This allows targeted modifications without affecting other records.

**What is needed to run the get_partner_candidates function?**
The get_partner_candidates tool requires authentication via your Partner API credentials. Once connected, it retrieves candidate status directly through the designated Partner API endpoints.

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