Greenhouse MCP Server
The Greenhouse MCP server lets your AI agents interact with Greenhouse recruiting data through the Harvest API (v3). Agents can browse job listings and posts, search candidates and applications, look up hiring team members, and explore departments and offices — all read-only.
Capabilities
| Tool | What It Does |
|---|---|
| List jobs | List jobs with filtering by status, department, or date range |
| Get job | Retrieve details for a specific job |
| List job posts | List published job posts with filtering options |
| Get job post | Retrieve a specific job post |
| List candidates | List candidates with filtering by date, email, or tag |
| Get candidate | Retrieve details for a specific candidate |
| List applications | List applications with filtering by job, status, or stage |
| Get application | Retrieve details for a specific application |
| List users | List Greenhouse users (hiring team members) |
| Get user | Retrieve details for a specific Greenhouse user |
| List departments | List departments in the organization |
| List offices | List offices in the organization |
📝 Note: All Greenhouse tools are read-only. The agent cannot create or modify candidates, applications, or jobs.
OAuth Setup
The Greenhouse MCP server uses OAuth to authenticate. To enable this integration, you need to create an OAuth application in Greenhouse and provide the credentials to Devs.ai.
Step 1: Create a Harvest API Key or OAuth App
- Sign in to Greenhouse as an admin.
- Go to Configure > Dev Center > API Credential Management.
- Click Create New API Key.
- Select Harvest as the API type.
- Configure the required permissions for the data your agents need to access.
Step 2: Get Your Credentials
- Copy the API Key or Client ID and Client Secret depending on your authentication method.
Step 3: Configure in Devs.ai
- Navigate to Organization > Connectors in Devs.ai.
- Find the Greenhouse template and click Enable.
- Select OAuth as the authentication type.
- Enter your credentials from Step 2.
- Select the tools you want to make available.
- Click Save.
OAuth Configuration Reference
| Field | Value |
|---|---|
| Scopes | harvest:jobs:list, harvest:job_posts:list, harvest:candidates:list, harvest:applications:list, harvest:users:list, harvest:departments:list, harvest:offices:list |