# Greenhouse MCP > Greenhouse MCP connects your AI agent directly to your recruiting pipeline. List candidates, track applications, audit job roles, and manage department data using natural conversation instead of dashboards. It gives you full visibility into hiring status without clicking through menus. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** hiring-pipeline, candidate-tracking, talent-acquisition, applicant-management, recruiting-automation, job-postings ## Description Managing a talent pipeline means juggling dozens of screens: the candidate list, the active jobs board, the team structure map. This MCP lets your agent access all that information inside Greenhouse—all from a simple chat prompt. You don't need to remember which dashboard holds user roles or how to find an application status; you just ask. Need to know who applied for 'Product Designer'? Ask it. Want to see if the HR team has updated their office list? Just ask. The agent pulls that data and presents it conversationally. Because this connection is managed through Vinkius, your agent can talk to Greenhouse alongside thousands of other services you use. You handle complex recruiting tasks using plain language chat, getting instant answers about everything from candidate profiles to departmental setup. ## Tools ### create_candidate Creates a new candidate profile record within Greenhouse. ### get_application Retrieves specific details for any job application ID you provide. ### get_candidate Fetches all profile information for a given candidate ID. ### get_job Gets detailed information about a specific job posting. ### get_user Retrieves the full profile and details for an existing Greenhouse user. ### list_applications Pulls a list of all job applications that have been submitted to your company. ### list_candidates Provides an overview and listing of every candidate in your system. ### list_departments Lists all current departments recognized within the company structure. ### list_job_stages Shows you all the defined stages (like Phone Screen or Interview) for a specific job title. ### list_jobs Lists every active and archived job posting in your Greenhouse account. ### list_offices Provides a list of all company office locations you manage. ### list_users Lists every user account in your Greenhouse workspace for auditing purposes. ## Prompt Examples **Prompt:** ``` List my active jobs in Greenhouse ``` **Response:** ``` Retrieving your active jobs... I found 4 openings: 'Senior Frontend Engineer' (ID: 402), 'Product Designer' (ID: 405), 'Marketing Manager' (ID: 410), and 'Data Scientist' (ID: 412). Would you like to see the applications for any of these? ``` **Prompt:** ``` Show me the profile for candidate ID 93021 ``` **Response:** ``` Fetching candidate details... Candidate #93021 is John Doe. He is currently in the 'Technical Interview' stage for the Senior Engineer role. His latest resume was uploaded 3 days ago. ``` **Prompt:** ``` What are the hiring stages for the 'Product Designer' job? ``` **Response:** ``` Retrieving job stages... For the 'Product Designer' role (ID: 405), the hiring process includes: 1. Application Review, 2. Portfolio Review, 3. Phone Screen, 4. Design Exercise, and 5. Executive Interview. ``` ## Capabilities ### Audit Candidate Records Retrieve full profile details for specific candidates or list all active users in your system. ### Track Application Statuses Monitor job applications and see their current status across any active hiring process. ### Manage Job Postings List and inspect all current job configurations, including department mapping and the exact stages of the hiring funnel. ### Build Organizational Maps Retrieve details about your company's office locations and internal departments to ensure data accuracy. ## Use Cases ### The Candidate Status Check A hiring manager needs to know if a promising candidate has progressed. Instead of logging into the application dashboard and searching by name, they ask their agent. The agent uses `get_candidate` to pull up the profile and instantly tells them which stage that person is in for the Senior Engineer role. ### The Department Structure Audit HR Operations needs to know if a new job falls under an existing department. They ask their agent, who uses `list_departments` and `get_job` to confirm both the organizational unit name and its proper mapping within Greenhouse. ### Building a New Job Role A recruiter is launching a new role and needs to know the standard process. They ask their agent, who runs `list_job_stages`, providing a clear list of mandatory steps (like Portfolio Review or Phone Screen) that must be included. ### Onboarding New Users An HR admin needs to verify user access for a newly joined department head. They use the agent, which runs `list_users` and `get_user`, to confirm current roles and necessary permissions without needing elevated dashboard rights. ## Benefits - Stop switching tabs to check status. Instead of navigating the application dashboard to see a candidate's progress, simply ask your agent for their current stage or retrieval details using `get_application`. - Audit your whole team instantly. Don't manually click through user lists; use the `list_users` tool to verify roles and access levels across departments in seconds. - Keep recruiters fast. Instead of manual searches, ask the agent to list all candidates or get details for a specific candidate using `get_candidate`, saving critical minutes on every search. - Understand your funnel structure. Before posting a role, use `list_job_stages` to see exactly what hiring steps are required for that job, ensuring nothing is missed. - See the big picture of your organization. Use the `list_departments` and `list_offices` tools to instantly map out where roles sit within your company structure when onboarding new jobs. ## How It Works The bottom line is, instead of navigating through multiple dashboards, your AI agent does all the clicking for you. 1. Subscribe to this MCP on Vinkius, then provide your Greenhouse Harvest API Key (v1/v2) in the connection settings. 2. Use your AI client's chat interface and ask a question about candidates or jobs. The agent translates that request into structured data calls. 3. The system fetches the relevant information from Greenhouse and presents it back to you as natural, conversational text. ## Frequently Asked Questions **Can I use Greenhouse MCP to create a new candidate profile?** Yes, you can. The agent has the `create_candidate` tool, letting you easily populate a brand-new profile record inside your system. **How does Greenhouse MCP handle department structures?** You use the tools like `list_departments` and `list_offices`. This lets you audit the company's full structure, making sure all hiring records match up with your official organizational map. **Does Greenhouse MCP track job status?** Absolutely. You can use tools like `list_jobs` and `get_job` to see every active posting, along with the defined steps for that role using `list_job_stages`. **What if I need to check a user's access level?** You can use the specialized tools like `list_users` and `get_user`. These allow you to verify specific roles and permissions within your Greenhouse workspace quickly. **Is Greenhouse MCP compatible with all AI clients?** Yes, this MCP is designed to work with any client that supports the Model Context Protocol (MCP), including Claude, Cursor, Windsurf, and VS Code.