Connect your AI Agents to Greenhouse in minutes

Available tools
list_applications
List applications with optional filters (job_id, status, timestamps). Returns candidate info, stage, status, and assignments. Supports pagination up to 500 per page.
get_application
Get detailed application by ID including candidate profile, current stage, status, rejection details, jobs, assignments, custom fields, and activity timeline.
create_application
Create a job application for a candidate. Requires candidate_id with at least one email. Use discover_custom_and_required_fields('application') to see org-specific requirements. Returns application with assigned stage.
advance_application
Advance application to next stage in hiring workflow. Requires from_stage_id matching current stage. Use get_application to verify stage and get_job_stages for valid transitions.
reject_application
Reject an active application with specified reason. Use list_reject_reasons for available options. Sets status to 'rejected'. Can be reversed with unreject_application.
unreject_application
Restore rejected application to active status. Application must currently be 'rejected'. Returns to previous stage and clears rejection details. Use get_application to verify status first.
hire_application
Mark candidate as hired. Requires start_date and on_behalf_of. Application must be active with complete offer and approvals. Use check_hire_readiness first to validate prerequisites.
move_application
Move application to any stage (forward or backward) within same job. Requires from_stage_id and to_stage_id. Unlike advance, allows non-sequential moves. Use get_job_stages for available stages.
transfer_application
Transfer application to different job. Requires target_job_id. Optionally specify target_stage_id (defaults to first stage). Preserves candidate info and history. Cannot transfer prospects.
check_hire_readiness
Validate application meets all hiring prerequisites. Checks status, offer completeness, approvals, and job openings. Returns readiness report with blocking issues and resolution steps. Use before hire_application.
add_application_note
Add note to application with visibility control (admin_only, private, or public). Records feedback and observations. Returns note_id and complete note data with timestamps.
list_candidates
List all candidates in Greenhouse with optional pagination and filtering by job_id, created_before/after, updated_before/after timestamps. Returns comprehensive candidate data including personal information (name, title, company), contact details (emails, phones, addresses), social media profiles, employment and education history, assigned recruiter and coordinator, candidate tags, attachments (resumes, cover letters), all associated applications with current stages, custom field values, and activity timestamps. Supports up to 500 candidates per page for efficient bulk retrieval.

How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Greenhouse MCP server
FAQs on using Merge's Greenhouse MCP server
How can I use the Greenhouse MCP server?
Here are just a few use cases:
- Interview scheduling: Your agent can coordinate interview availability by checking candidate responses, reviewing interviewer calendars, and proposing optimal time slots. It can then create the interview in Greenhouse and send calendar invites once approved
- Application screening: Your agent can periodically review new applications, extract key qualifications from resumes, and flag high-priority candidates based on predefined criteria. It can also move candidates through pipeline stages and add screening notes automatically
- Candidate status updates: Your agent can monitor candidates who haven't received updates in a while and draft status update emails to keep them engaged. For instance, it can detect candidates stuck in a stage for over a week and propose follow-up communications
- New hire onboarding prep: Your agent can monitor for accepted offers in Greenhouse and trigger onboarding workflows in your HRIS (e.g., BambooHR, Workday). For example, it can create the employee record in the HRIS, pre-fill details from the candidate profile, and notify IT to start procuring/provisioning equipment and application access
- Reference check automation: Your agent can identify candidates ready for reference checks in Greenhouse, extract reference contact details, and initiate reference check requests through your reference checking platform (e.g., Checkr, Xref). Your agent can then log the results back in Greenhouse once the check is complete
What are popular tools for Greenhouse’s MCP server?
Here are just a few popular tools across data types:
Applications
- <code class="blog_inline-code">list_applications</code>
- <code class="blog_inline-code">get_application</code>
- <code class="blog_inline-code">create_application</code>
- <code class="blog_inline-code">advance_application</code>
- <code class="blog_inline-code">reject_application</code>
Candidates
- <code class="blog_inline-code">list_candidates</code>
- <code class="blog_inline-code">get_candidate</code>
- <code class="blog_inline-code">create_candidate</code>
- <code class="blog_inline-code">Add_candidate_note</code>
Jobs
- <code class="blog_inline-code">get_job_stages</code>
- <code class="blog_inline-code">list_job_openings</code>
- <code class="blog_inline-code">create_job_opening</code>
- <code class="blog_inline-code">get_job_approval_flows</code>
What makes Merge Agent Handler’s Greenhouse MCP server better than alternative Greenhouse MCP servers?
Merge Agent Handler provides platform-level capabilities that aren’t inherent to MCP alone:
- Enterprise-grade security and DLP: All tool inputs and outputs are scanned by a security gateway with configurable data loss prevention rules to block, redact, or mask sensitive data
- Real-time observability and auditability: Every tool call is logged with a complete, fully-searchable audit trail, enabling teams to debug, review, and manage agent behavior
- Managed authentication and permissions: Merge handles dynamic authentication flows, credential storage, and permission validation for registered users, reducing integration complexity
- Broad and customizable tool coverage: Merge’s Greenhouse connector comes with 50+ tools out of the box. You can also easily add your own or modify existing ones to fit your exact requirements
Can I set security rules for Greenhouse tool calls in Merge Agent Handler?
Yes, you can set a wide range of security rules for Greenhouse tool calls in Merge Agent Handler. Here are just a few examples:
- Block candidate PII in tickets: Prevent your agents from including candidate social security numbers, home addresses, or phone numbers when creating tickets or notes in other systems based on Greenhouse data
- Redact salary information: Automatically mask compensation details and salary ranges from Greenhouse job requisitions or offer letters before your agents share candidate information across systems
- Log sensitive searches: Track and audit whenever your agents search Greenhouse for candidates with specific demographic information or protected characteristics
- Block external email domains: Prevent your agents from sending candidate data to email addresses outside your organization's domain when drafting outreach messages
- Redact interview feedback: Automatically strip confidential interviewer comments or sensitive evaluation notes before your agents summarize candidate profiles or create reports
- Block unauthorized data exports: Prevent your agents from bulk extracting candidate records or application data that could violate data retention policies
How can I add tools to Merge Agent Handler’s Greenhouse MCP server?
Here are the steps to get started:
1. Create your Agent Handler account. Sign up for a free Merge Agent Handler account here.
2. Set up a Tool Pack. Navigate to "Tool Packs" in the dashboard sidebar and click "Create New Tool Pack." Add the Greenhouse connector from the list of available MCP connectors and give your Tool Pack a descriptive name (e.g., "Recruiting Automation Pack").
3. Configure authentication. Choose between individual authentication, where each user provides their own Greenhouse credentials, and shared authentication, which uses organization-level credentials for all users.
4. Register a user identity. Navigate to "Registered Users" and create an entry. This represents the identity (either human or system) that’ll perform actions through your agent.
5. Associate the Tool Pack with your agent. Save your Tool Pack and connect it to your agent using the MCP entry URL provided in the Tool Pack settings.
Explore other MCP servers built and managed by Merge








Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
