mcpengine/servers/greenhouse

Greenhouse MCP Server

MCP server for the Greenhouse ATS (Applicant Tracking System) and recruiting platform, providing comprehensive tools for managing candidates, applications, jobs, offers, scorecards, and users.

Features

• Candidate Management - Browse, create, and update candidate profiles
• Application Tracking - Track applications through hiring pipeline
• Job Management - Create and manage job postings
• Offers - Review and manage job offers
• Scorecards - Access interview evaluations
• User Management - Browse hiring team members

Installation

npm install
npm run build

Configuration

Set your Greenhouse API key as an environment variable:

export GREENHOUSE_API_KEY="your_api_key_here"

Usage

Run the server:

npm start
# or
node dist/index.js

Available Tools (18 total)

Candidates (4 tools)

• list_candidates - Browse candidate database with pagination
• get_candidate - Get detailed candidate information
• create_candidate - Add new candidates
• update_candidate - Modify candidate details

Applications (4 tools)

• list_applications - View applications across all jobs
• get_application - Get detailed application information
• advance_stage - Move application to next pipeline stage
• reject_application - Reject application with reason

Jobs (4 tools)

• list_jobs - Browse all job postings
• get_job - Get detailed job configuration
• create_job - Create new job posting
• update_job - Modify job details

Offers & Scorecards (4 tools)

• list_offers - Review job offers
• get_offer - Get detailed offer information
• list_scorecards - Browse interview scorecards
• get_scorecard - Get detailed interview feedback

Users (2 tools)

• list_users - Browse team members
• get_user - Get user details

API Coverage Manifest

Total Greenhouse API Endpoints: ~100+
Implemented in this server: 18
Coverage: ~18%

Covered Areas:

• ✅ Candidate CRUD operations
• ✅ Application management and progression
• ✅ Job posting management
• ✅ Offer tracking
• ✅ Scorecard/interview feedback access
• ✅ User listing

Not Yet Implemented:

• ⏳ Interview scheduling
• ⏳ Email templates
• ⏳ Custom fields management
• ⏳ Departments and offices CRUD
• ⏳ Job stages configuration
• ⏳ Rejection reasons
• ⏳ Activity feed
• ⏳ Tags management
• ⏳ Prospect pools
• ⏳ EEOC data
• ⏳ Approvals
• ⏳ Scheduled interviews

Architecture

greenhouse/
├── src/
│   ├── index.ts                     # MCP server entry point
│   ├── client/
│   │   └── greenhouse-client.ts    # API client with rate limiting
│   ├── tools/
│   │   ├── candidates.ts           # Candidate tools
│   │   ├── applications.ts         # Application tools
│   │   ├── jobs.ts                 # Job tools
│   │   ├── offers.ts               # Offer & scorecard tools
│   │   └── users.ts                # User tools
│   └── types/
│       └── index.ts                # TypeScript interfaces
├── package.json
├── tsconfig.json
└── README.md

Rate Limiting

The client implements automatic rate limiting:

• Max 10 concurrent requests
• Minimum 100ms between requests
• Automatic backoff on 429 responses

Error Handling

The server provides detailed error messages for:

• Authentication failures (401)
• Permission issues (403)
• Resource not found (404)
• Validation errors (422)
• Rate limit exceeded (429)
• Server errors (500+)

License

MIT