Greenhouse MCP Server 🌱

An MCP (Model Context Protocol) server for interacting with the Greenhouse Harvest API. This server enables AI agents to manage recruitment workflows through Greenhouse’s applicant tracking system.

Features

The Greenhouse MCP server provides tools for:

Jobs Management

• list_jobs - List all jobs with filtering options
• get_job - Get detailed information about a specific job

Candidate Management

• list_candidates - Search and list candidates
• get_candidate - Get detailed candidate information
• create_candidate - Add new candidates to the system
• update_candidate - Update existing candidate information
• add_note_to_candidate - Add notes to candidate profiles

Application Tracking

• list_applications - List applications with filtering
• get_application - Get detailed application information
• advance_application - Move applications through hiring stages
• reject_application - Reject applications with reasons
• add_note_to_application - Add notes to applications

Organization Data

• list_departments - List all departments
• list_offices - List all offices
• list_users - List Greenhouse users

Installation

Prerequisites

• Python 3.9+
• Greenhouse API key (obtain from your Greenhouse admin panel)

Install via pip

pip install greenhouse-mcp

Install from source

git clone https://github.com/yourusername/greenhouse-mcp.git
cd greenhouse-mcp
pip install -e .

Configuration

Create a .env file in your project root:

GREENHOUSE_API_KEY=your_api_key_here
GREENHOUSE_BASE_URL=https://harvest.greenhouse.io/v1  # Optional, this is the default

Usage

Running Locally with FastMCP

# Using FastMCP CLI
fastmcp run src.greenhouse_mcp:mcp

# Or with Python directly
python -m src.greenhouse_mcp

Using with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "greenhouse": {
      "command": "uvx",
      "args": ["greenhouse-mcp"],
      "env": {
        "GREENHOUSE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Using with MCPD

1. Install MCPD:

npm install -g @modelcontextprotocol/mcpd

2. Add the server to MCPD:

mcpd add greenhouse-mcp

3. Configure environment variables:

mcpd config args set greenhouse-mcp --env GREENHOUSE_API_KEY=your_api_key_here

4. Start the MCPD daemon:

mcpd daemon

The server will be available at http://localhost:8090 with API documentation at /docs.

Example Usage

Once connected to an AI assistant, you can use natural language to interact with Greenhouse:

"List all open engineering jobs"
"Show me candidates who applied in the last week"
"Get details for candidate ID 12345"
"Add a note to application 67890 saying 'Strong technical skills, schedule second interview'"